DISCARD IPCONN

Remove an IPCONN definition.

Syntax

Warning: System commands are powerful as they provide information about the state of the system and allow changes to be made to it. System commands should be used only by authorized applications and users.

Activate security checks on commands by specifying the XCMD system initialization parameter and by ensuring that command security checking is active for the transaction (either by specifying CMDSEC(YES) on the TRANSACTION resource definition or by specifying ALWAYS on the CMDSEC system initialization parameter).

DISCARD IPCONN

Conditions: INVREQ, NOTAUTH, SYSIDERR

NOHANDLE, RESP, and RESP2 are common options that can be added to all EXEC CICS commands to process error conditions. They are not explicitly included in the command syntax diagram and option descriptions. For information about these common options and EXEC CICS command syntax, see EXEC CICS command format and programming considerations.

Description

The DISCARD IPCONN command removes an IPCONN definition from the local CICS® system.

You cannot discard an IPCONN unless it is in OUTSERVICE status.

See Discarding resource definitions for general information about DISCARD commands.

Options

IPCONN(data-value): specifies the 8-character name of the IPCONN definition to be discarded.

Conditions

INVREQ

RESP2 values:

5: The IPCONN is in service.
9: The IPCONN does not exist.
27: Discard processing failed.

NOTAUTH

RESP2 values:

100: The user associated with the issuing task is not authorized to use this command.

SYSIDERR

RESP2 values:

9: The IPCONN name was not found.