The SET APPLICATION command

Change the state of an installed application to the specified target state, in a platform within the current CICSplex. For example, the SET APPLICATION command can change the state of an application from AVAILABLE to UNAVAILABLE.

Read syntax diagramSkip visual syntax diagramSET APPLICATION( data-value)VERSION( data-value)PLATFORM( data-value)STATE(AVAILABLE)STATE(UNAVAILABLE)STATE(ENABLED)STATE(DISABLED)TIMEOUT( 300)TIMEOUT( data-value)

Options

APPLICATION (data-value)
Specifies the application definition name (up to 8 characters) of the CICS application to change state.
PLATFORM (data-value)
Specifies the platform definition name (up to 8 characters) of the CICS® platform on which the application changes state.
STATE (AVAILABLE | UNAVAILABLE | ENABLED | DISABLED)
Specifies the target state of the application. The following options are valid:
  • AVAILABLE: Enable the application, and make it available.
  • UNAVAILABLE: Make the application unavailable and wait for tasks that are associated with the current application operation to complete.
  • ENABLED: Enable the application.
  • DISABLED: Make the application unavailable, waits for tasks that are associated with the current application operation to complete, and then disables the application.
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 to change state. This is in the form (x.y.z) where x, y and z specify a number 0-255.

Example

The following example connects to MYPLEX and sets the state of APP1 to DISABLED: 
//DFHDPLY1 JOB CLASS=A,MSGCLASS=A,NOTIFY=&SYSUID
//*
//DFHDPLOY EXEC PGM=DFHDPLOY
//*
//STEPLIB  DD DISP=SHR,DSN=CICSTS54.CICS.SDFHLOAD
//         DD DISP=SHR,DSN=CICSTS54.CPSM.SEYUAUTH
//SYSTSPRT DD SYSOUT=*
//SYSIN    DD *
SET CICSPLEX(MYPLEX);
*
SET APPLICATION(APP1) VERSION(1.0.1)
  PLATFORM(MYPLAT2) STATE(DISABLED) TIMEOUT(20);
/*