DISCARD

Discard a result set, filter, or view.

Read syntax diagramSkip visual syntax diagramDISCARDFILTER(cpsm-token)RESULT(cpsm-token)VIEW(data-value)THREAD(cpsm-token) RESPONSE(data-ref )REASON(data-ref )

Description

This command discards a result set, filter, or view.

Related commands

COPY, GET, GETDEF, GROUP, PERFORM OBJECT, SPECIFY FILTER, SPECIFY VIEW

Options

FILTER(cpsm-token)
Identifies the filter to be discarded. The cpsm-token value that identifies a filter is returned by the SPECIFY FILTER command.
REASON(data-ref)
Names a variable to receive the fullword reason value returned by this command.
RESPONSE(data-ref)
Names a variable to receive the fullword response value returned by this command.
RESULT(cpsm-token)
Identifies the API result set to be discarded. The result set can be one produced by any of these commands:
  • COPY
  • GET
  • GETDEF
  • GROUP
  • PERFORM OBJECT.
Note: If you discard a result set that was summarized by the GROUP command, all of the summarized result sets are also discarded.
THREAD(cpsm-token)
Identifies the API thread to be used for this operation. The cpsm-token value that identifies a thread is returned by the CONNECT command.
VIEW(data-value)
Identifies the view to be discarded. This value must be the 1- to 8-character name of a view as defined on a SPECIFY VIEW command.

Conditions

The following is a list of the RESPONSE values that can be returned by the DISCARD command. The description of each RESPONSE includes a list of associated REASON values, if appropriate.
OK
The command completed processing successfully.
BUSY
A busy condition occurred for the following reason:
RESULT
The result set specified on the RESULT option is being processed by another command.
ENVIRONERROR
An environment error occurred for one of the following reasons:
NOSERVICE
The application stub program could not load the API service module.
NOSTORAGE
The application stub program could not obtain the necessary storage in the address space where the processing thread is running.
SOCRESOURCE
A required resource that is owned by the CMAS is not available.
FAILED
The command failed for one of the following reasons:
ABENDED
Command processing abended.
EXCEPTION
Command processing encountered an exceptional condition.
INUSE
An in use condition occurred for one of the following reasons:
FILTER
The specified filter is currently in use and cannot be discarded.
VIEW
The specified view is currently in use and cannot be discarded.
INVALIDPARM
An invalid parameter was detected. The parameter that is invalid is returned as the reason value:
  • FILTER
  • RESULT
  • THREAD
  • VIEW.
Check the command description for valid parameter syntax.
NOTAVAILABLE
A not available condition occurred for one of the following reasons:
APITASK
The API control subtask is not active.
CPSMAPI
The CMAS to which the processing thread is connected is not available for API processing.
SERVERGONE
The CMAS to which the processing thread was connected is no longer active.
VERSIONINVL
A version conflict occurred for one of the following reasons:
NOTSUPPORTED
The version of the application stub program used for this command is not supported.
NOTVSNCONN
The version of the application stub program used for this command is not the same as the version used with the CONNECT command.