VERASE—remove variables from shared or profile pool

The VERASE service removes variable names and values from the shared pool, the application profile pool, or both. System variables, variable type 'non-modifiable', cannot be removed by using the VERASE service.

Command invocation format


                               .-ASIS----.   
>>-ISPEXEC--VERASE--name-list--+---------+---------------------><
                               +-SHARED--+   
                               +-PROFILE-+   
                               '-BOTH----'

Call invocation format


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


                                               .-'ASISbbbb'-.   
>>-CALL--ISPLINK--('VERASEbb'--,--name-list--,-+-'b'--------+--->
                                               +-SHARED--'--+   
                                               +-'PROFILEb'-+   
                                               '-'BOTHbbbb'-'   

>--);----------------------------------------------------------><

Parameters

name-list: Specifies the dialog variable names that are to be removed from the shared or application profile pool.
ASIS: Specifies that the variables are to be removed from the shared pool or, if not found in the shared pool, they are to be removed from the application profile pool. ASIS is the default value.
SHARED: Specifies that the variables are to be removed from the shared pool.
PROFILE: Specifies that the variables are to be removed from the application profile pool.
BOTH: Specifies that the variables are to be removed from both the shared pool and the application profile pools.
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.

Return codes

These return codes are possible:

0: Normal completion.
8: At least one variable not found.
20: Severe error.

Note:

ISPF processes the entire name list even if it cannot find one or more of the variable names in the list.
With BOTH specified, a 0 return code indicates that ISPF found and removed the variable from the profile and/or the shared pool. A return code of 8 indicates that ISPF did not find or remove the variable from either the profile or the shared pool.
Be careful not to erase variables that provide functions for you during the ISPF session. For example, if you erase function key variables (ZPF01-ZPF24) and do not subsequently specify them, the keys become inoperative.

Example

In a CLIST, remove variables NAME, PHONE, and ADDRESS from both the shared and application profile pools.

ISPEXEC VERASE (NAME PHONE ADDRESS) BOTH

or alternately

Set program variable BUFFER to:

VERASE (NAME PHONE ADDRESS) BOTH

Then set program variable BUFLEN to the length of variable BUFFER and issue the command:

  CALL ISPEXEC (BUFLEN, BUFFER);

or alternately

CALL ISPLINK ('VERASE  ','(NAME PHONE ADDRESS)','BOTH    ');