The UNDEPLOY APPLICATION command

Change a CICS® application to a specified target state of UNAVAILABLE, DISABLED, or DISCARDED in a platform within the current CICSplex.

Read syntax diagramSkip visual syntax diagramUNDEPLOY APPLICATION( data-value)VERSION( data-value)PLATFORM( data-value)STATE(UNAVAILABLE)STATE(DISABLED)STATE(DISCARDED)TIMEOUT( 300)TIMEOUT( data-value)

Options

APPLICATION (data-value)
Specifies the name of the application definition (up to 8 characters) to undeploy.
PLATFORM (data-value)
Specifies the platform definition name (up to 8 characters) of the CICS platform to undeploy the application from.
STATE (UNAVAILABLE | DISABLED | DISCARDED)
Specifies the target state of the application. The following options are valid:
  • UNAVAILABLE: Makes the application unavailable and waits for tasks that are associated with the current application operation to complete.
  • DISABLED: Makes the application unavailable, waits for tasks that are associated with the current application operation to complete, and then disables the application.
  • DISCARDED: Makes the application unavailable, waits for tasks that are associated with the current application operation to complete, disables the application, and then discards the application object and definition.
Note: A CICS task in one application context can link to an entry point in another CICS application, such that the current application context is stacked. DFHDPLOY does not wait for tasks that have a stacked application context to complete.
TIMEOUT ( 300 | data-value)
An optional numerical value that specifies the maximum amount of time in seconds (1 - 1800 inclusive) for the command to complete. For more information about how to choose an appropriate TIMEOUT value, see Troubleshooting the DFHDPLOY utility.
VERSION (data-value)
Denotes the cloud style version number of the application that is being undeployed, in the form (x.y.z) where x, y, and z specify a number 0-255.

Example

The following example connects to MYPLEX and undeploys application APP1 to a discarded state: 
//DFHDPLY1 JOB CLASS=A,MSGCLASS=A,NOTIFY=&SYSUID
//*
//DFHDPLOY EXEC PGM=DFHDPLOY
//*
//STEPLIB  DD DISP=SHR,DSN=CICSTS55.CICS.SDFHLOAD
//         DD DISP=SHR,DSN=CICSTS55.CPSM.SEYUAUTH
//SYSTSPRT DD SYSOUT=*
//SYSIN    DD *
SET CICSPLEX(MYPLEX);
*
UNDEPLOY APPLICATION(APP1) VERSION(1.0.1)
  PLATFORM(MYPLAT1) STATE(DISCARDED) TIMEOUT(20);
/*

For more information about the states of an application during undeployment, see Checking the status of an application in the CICS Explorer product documentation.