The DEPLOY APPLICATION command

Define a CICS® application and change its state to DISABLED, ENABLED, or AVAILABLE in a platform within the current CICSplex.

Read syntax diagramSkip visual syntax diagramDEPLOY APPLICATION( data-value)APPLDIR( data-value)BINDDIR( data-value)DESCRIPTION( text)STATE(DISABLED)STATE(ENABLED)STATE(AVAILABLE)TIMEOUT( 300)TIMEOUT( data-value)

Options

APPLICATION(data-value)
Specifies the name of the application definition (up to 8 characters) that is used by CICS.
APPLDIR(data-value)
Specifies the location of the application bundle (up to 255 characters) on zFS.
BINDDIR(data-value)
Specifies the location of the application binding bundle (up to 255 characters) on zFS.
DESCRIPTION(text)
An optional value that specifies a description of the application definition (up to 58 characters).
STATE(DISABLED | ENABLED | AVAILABLE)
Specifies the target state of the application. The following options are valid:
  • DISABLED: Creates the application definition, installs the definition, then changes the application state to disabled and unavailable.
  • ENABLED: Creates the application definition, installs the definition, then changes the application state to enabled and unavailable.
  • AVAILABLE: Creates the application definition, installs the definition, then changes the application state to enabled and available.
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 DFHDPLOY - Timeout.

Example usage

This example connects to MYPLEX and deploys application APP1 to an available state:
//DFHDPLY1 JOB CLASS=A,MSGCLASS=A,NOTIFY=&SYSUID
//*                                            
//DFHDPLOY  EXEC PGM=DFHDPLOY                   
//*                                            
//STEPLIB   DD   DISP=SHR,DSN=CICSTS53.CICS.SDFHLOAD
//          DD   DISP=SHR,DSN=CICSTS53.CPSM.SEYUAUTH 
//SYSTSPRT  DD   SYSOUT=*
//SYSIN     DD   * 
SET CICSPLEX(MYPLEX);
*
DEPLOY APPLICATION(APP1) STATE(AVAILABLE)
APPLDIR(/var/cicsts/MYPLEX/platform1/applications/application1/)
BINDDIR(/var/cicsts/MYPLEX/platform1/bindings/binding1/);
/*

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