v
An INQUIRE TRANSACTION NEXT or INQUIRE TRANSACTION END is issued, but an INQUIRE TRANSACTION START command has not been successfully issued.
Default action: Terminate the task abnormally.
PERFORM SHUTDOWN command
EXEC CICS PERFORM SHUTDOWN
DUMP IMMEDIATE
Condition:
INVREQ
The EXEC CICS PERFORM SHUTDOWN command shuts down the local CICS system. The shutdown can be either controlled or immediate.
If this command starts successfully, control cannot be returned to the issuing task.
Options
DUMP
indicates whether a CICS dump is to be taken as part of the shutdown process.
If it is not specified, no dump is taken.
IMMEDIATE
indicates whether the CICS system is to shut down immediately, terminating all active CICS tasks and communication sessions. If IMMEDIATE is not specified, all CICS tasks are allowed to finish, and SNA sessions are allowed to terminate normally.
Exception Conditions
INVREQ
occurs if a normal shutdown has been requested but one is already in progress
(RESP2=1).
Default action: Terminate the task abnormally.
SET commands
This section describes the EXEC CICS SET commands in alphabetic order.
SET CONNECTION
(
name
)
PURGETYPE
PURGE
(
cvda
) SERVSTATUS
INSERVICE
OUTSERVICE
(
cvda
)
Conditions:
INVREQ, SYSIDERR
The EXEC CICS SET CONNECTION command changes some of the information of a named CICS connection definition (sometimes known as a system entry) in the
CICS control region.
Chapter 33. System programming reference
509
Options
CONNECTION(name)
is the name of the connection (that is, the remote system, or another CICS control region) as specified in the SYSID parameter within the OS/400
ADDCICSTCS CL command.
PURGETYPE(cvda)
causes the specified CICS connection to purge associated CICS tasks. The input
CVDA value is:
PURGE
Transactions can be terminated only if system and data integrity can be maintained.
A task is not purged if its associated transaction definition specified *NO in the PURGE parameter in the OS/400
ADDCICSPCT CL command.
SERVSTATUS(cvda)
causes the specified CICS connection to start or stop the ability to receive and send data. The input CVDA values are:
INSERVICE
Data is allowed to be sent and received.
OUTSERVICE
Data is not allowed to be sent or received.
Exception Conditions
INVREQ
occurs if: v
SERVSTATUS has an incorrect CVDA value (RESP2=4). v
PURGETYPE has an incorrect CVDA value (RESP2=7). v
The EXEC CICS SET command is named on an indirect connection
(RESP2=16).
Default action: Terminate the task abnormally.
SYSIDERR
occurs if the named connection cannot be found (RESP2=9).
Default action: Terminate the task abnormally.
510
CICS for iSeries Application Programming Guide V5
