In the CICS Explorer, the Programs operations view provides
a functional equivalent to this command.
Description
You can use the CEMT
transaction to modify only programs that are defined in the CICS® system definition (CSD) file
and installed in the running CICS system.
You cannot use the CEMT SET PROGRAM command for
programs that were defined and installed in a CICS bundle. - You can control the status of dynamically generated PROGRAM resources by enabling or disabling the BUNDLE resources that installed them.
- You can modify the definition of dynamically generated PROGRAM
resources by using the resource editor in CICS Explorer®.
To update the definition, replace the old version of the CICS bundle with the new one, following the
instructions in the section
Working with bundles
in the CICS Explorer User Guide, in the CICS Explorer help. CICS bundles that were deployed on their own or with a platform can be updated individually. If the CICS bundle was deployed as part of an application or with an application binding, update the whole application.
Syntax
- Type CEMT SET PROGRAM with pgrmid, CLASS(value), or ALL. The status is displayed, similar to the status obtained by CEMT INQUIRE PROGRAM. You can then use the tab key to navigate to the highlighted or blank fields and type the required values.
- Type CEMT SET PROGRAM followed by one or more attribute settings that you want to change. For example, cemt s prog(pgrmid) e ne resets the values for the named program to make it available for use (enabled). A new copy of the program is used when all the transactions currently using the program finish (newcopy).
Typing ? at the beginning of either the first or second line gives a syntax prompt. Resetting the values takes effect immediately.
CEMT SET PROGRAM >>-CEMT SET PROGRAM--+-(value)------+--+----------+-------------> +-ALL----------+ +-ENABLED--+ '-CLASS(value)-' '-DISABLED-' .-PRIVATE-. >--+---------+--+---------+--+--------+--+-----------+----------> '-SHARED--' +-NEWCOPY-+ +-CEDF---+ +-DPLSUBSET-+ '-PHASEIN-' '-NOCEDF-' '-FULLAPI---' >--+-----------------+--+-------------------+-------------------> '-JVMCLASS(value)-' '-JVMPROFILE(value)-' >--+------------------+--+-------+----------------------------->< '-OPERATION(value)-' +-JVM---+ '-NOJVM-'
Options
- (value)
- Specifies
a program identifier (1–8 characters), which is the name of a specific
program entry in the table of installed program definitions. If you
omit the program name, the ALL option is assumed by default.
You cannot specify the CLASS option and a program name.
- ALL
- Specifies
that any changes you request are to be made to all resources of the
specified type that you are authorized to access, up to a maximum
of 32766. If this limit is exceeded, the request fails and no resources
are updated.
- CEDF
- When EDF is active, CEDF initiation and termination screens are to be shown by CEDF while this program is running. Other screens are also to be shown unless the program was translated using the NOEDF translator option.
- CLASS (value)
- Specifies
the 2-character suffix of a program list table (PLT). Use this option
to inquire on those programs defined in the specified PLT. Unlike
a shutdown PLT, it is not mandatory to define a program definition
for a startup PLT. However, if you want to use the CLASS option, you
must define and install a program resource definition for the PLT
specified by clasid.
If the clasid specified is the suffix of a PLT that does not have a program definition, the INQUIRE PROGRAM CLASS(clasid) command returns a CLASS NOT FOUND message.
You cannot specify CLASS and a program name.
- DISABLED
- The program is not available for use. Programs beginning with “DFH” cannot be disabled because these characters are reserved for use by CICS.
- DPLSUBSET
- The
program is restricted to the DPL API subset, as for a distributed
program link request, when it runs in the local CICS region.
A program is always restricted to the DPL subset when it is invoked in a remote region via a DPL request, regardless of this option.
- ENABLED
- The program is available for use.
- FULLAPI
- The program is not restricted to the DPL subset of the CICS API when it runs in the local CICS region, and can use the full API.
- JVM
- The program is to run in a pooled Java™ Virtual Machine (JVM).
- JVMCLASS (value)
- Specifies the name of the main class in the Java program that is to be given control by the JVM.
- JVMPROFILE (value)
- Specifies
the 8-character name of a JVM profile that is to be used for the pooled
JVM in which this Java program
runs. Any instances of this program that are currently running in
a pooled JVM with the old JVM profile are unaffected, and are allowed
to finish running. You cannot enter a JVM profile for Java programs that run in a JVM server because
the JVM profile is set on the JVMSERVER resource.
You must enter the profile name using the same combination of uppercase and lowercase characters that are present in the z/OS® UNIX file name. If you enter the name of a JVM profile in mixed case when you are using the CEMT transaction, ensure that the terminal has uppercase translation suppressed.
- NEWCOPY
- CICS is to use a new copy of the
program when the program ceases to be in use by any transaction. You
can determine whether a module is in use from the RESCOUNT option
in an INQUIRE PROGRAM command. A value of zero
means the program is not in use. It is possible for CICS to replace the program with the new version
during a single transaction, at a point when one use of the program
has completed, and a subsequent use has yet to start.
CICS loads the new version either from the DFHRPL or dynamic LIBRARY concatenation, or uses an LPA-resident version, depending on the PRIVATE or SHARED options. PRIVATE is the default setting.
You cannot specify NEWCOPY for a program specified with the HOLD option or for a Java program that runs in a JVM. Use the PERFORM JVMPOOL PHASEOUT command to refresh Java programs that run in a pooled JVM. Disable and enable the JVMSERVER resource to refresh a Java program that runs in a JVM server.
- NOJVM
- The program is not to run in a JVM. Any value in the JVMCLASS option is ignored and the runtime environment of the program is unknown until it is next loaded by CICS, at which point its runtime environment is determined.
- NOCEDF
- All CEDF activities, including initiation and termination screens, are to stop while this program is being processed.
- OPERATION
- Specifies the name (up to 64 characters) of the application
operation for which this program is defined as an entry point. You
cannot set the OPERATION option if a program resource is being used
as an entry point by a CICS bundle. If you define and install a PROGRAM
with CSD, then install a bundle that modifies the program to be used
as an entry point, the PROGRAM cannot be overridden. You cannot specify
this value for CICS programs
(those beginning with ‘DFH').
- PHASEIN
- CICS uses a new copy of the program
now for all new transaction requests. CICS continues
to use the old copy for all currently running transactions until they
finish (RESCOUNT equal to zero). CICS loads
the new version either from the DFHRPL or dynamic LIBRARY concatenation,
or uses an LPA-resident version, depending on the PRIVATE or SHARED
options. PRIVATE is the default setting.
PHASEIN performs a REFRESH PROGRAM function to inform the loader domain that a new version of the program is cataloged and that this version of the named program must be used in all future ACQUIRE requests.
Until the program goes to a zero RESCOUNT and a subsequent ACQUIRE PROGRAM is performed, CEMT INQUIRE PROGRAM ( ) returns information about the first copy of the program.
You cannot specify PHASEIN for a program specified with the HOLD option or for a Java program that runs in a JVM. Use the PERFORM JVMPOOL PHASEOUT command to refresh Java programs that run in a pooled JVM. Disable and enable the JVMSERVER resource to refresh a Java program that runs in a JVM server.
- PRIVATE
- The next new copy of the program is to be loaded from the DFHRPL or dynamic LIBRARY concatenation. This is the default action.
- SHARED
- CICS uses a shared copy of the program from the LPA as the next new copy of the program. This value is ignored for a Java program that runs in a JVM.
