Change a PROGRAM, MAPSET, or PARTITIONSET definition.
SET PROGRAM >>-SET PROGRAM(data-value)--+------------------+----------------> +-CEDFSTATUS(cvda)-+ +-CEDF-------------+ '-NOCEDF-----------' >--+------------+--+--------------------+-----------------------> +-COPY(cvda)-+ +-EXECUTIONSET(cvda)-+ +-NEWCOPY----+ +-DPLSUBSET----------+ '-PHASEIN----' '-FULLAPI------------' >--+------------------------------------+-----------------------> '-JVMCLASS(255-character data-value)-' >--+------------------------------------+--+---------------+----> '-JVMPROFILE(8-character data-value)-' +-RUNTIME(cvda)-+ +-JVM-----------+ '-NOJVM---------' >--+-------------------+--+--------------+--+---------------+-->< +-SHARESTATUS(cvda)-+ +-STATUS(cvda)-+ '-VERSION(cvda)-' +-PRIVATE-----------+ +-DISABLED-----+ '-SHARED------------' '-ENABLED------'
Conditions: INVREQ, IOERROR, NOTAUTH, PGMIDERR
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
The SET PROGRAM command modifies the definition of a particular program, map set, or partition set installed in your CICS system. All of these resources are load modules and, therefore, CICS uses the same SET command for all three. To avoid confusion, we use the word module to refer to the object of your command, except when the option applies only to executable programs.
You cannot specify CEDFSTATUS for a remote program.
CICS does not load the module at this time, but it does ensure that a copy is available. If you have specified the SHARED option and the module is in the link-pack area, the LPA copy satisfies this requirement. Otherwise, CICS searches the concatenated DFHRPL libraries, and returns an IOERR exception if it cannot locate a copy there. CVDA values are:
This
option is not valid for JVM programs, and is ignored if specified. You can
achieve a synchronized replacement of a JVM program by using the command:
SET JVMPOOL PHASEOUT
This
option is permitted for JVM programs, but it is ignored
if specified. You can achieve a synchronized replacement of a JVM program
by using the command:
SET JVMPOOL PHASEOUT
COPY cannot be specified for any module currently loaded with the HOLD option, or for any program defined as remote.
The EXECUTIONSET attribute applies only:
When you use the name of a JVM profile anywhere in CICS, you must enter it using the same combination of upper and lower case characters that is present in the HFS file name.
For a program defined as remote, this option governs availability only when the program is invoked through the local CICS system; it does not change availability on the remote system.
The ENABLED and DISABLED option are honored for a program that is invoked through a CICS program link request, but they have no effect if the program is invoked by a Java program through a method call.
EXEC CICS SET PROGRAM ('PROGA')
PHASEIN
PRIVATE
DISABLED
In this example, CICS is to make module PROGA unavailable for new requests, and to locate a new copy in one of the DFHRPL libraries. Any copies of PROGA with a non-zero RESCOUNT will remain until no longer in use, but new requests for PROGA will fail until PROGA is set to ENABLED status. On the first request after the module is enabled, CICS loads the new copy and makes it the current one.