The DEPLOY APPLICATION command
Define a CICS® application and change its state to DISABLED, ENABLED, or AVAILABLE in a platform within the current CICSplex.
>>-DEPLOY APPLICATION(data-value)--APPLDIR(data-value)----------> >--BINDDIR(data-value)--+-------------------+-------------------> '-DESCRIPTION(text)-' .-TIMEOUT(300)--------. >--+-STATE(DISABLED)--+--+---------------------+--------------->< +-STATE(ENABLED)---+ '-TIMEOUT(data-value)-' '-STATE(AVAILABLE)-'
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 the DFHDPLOY utility.
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=
CICSTS54.CICS
.SDFHLOAD
// DD DISP=SHR,DSN=
CICSTS54.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.
