CEMT SET PROGRAM

Change the attributes of installed programs.

In the CICS Explorer, the Programs 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 file (CSD) 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 Working with bundles in the CICS Explorer product documentation. 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

Press the clear key. There are two ways to start this transaction:
  • 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

Read syntax diagramSkip visual syntax diagramCEMT SET PROGRAM( value)ALLCLASS( value)ENABLEDDISABLEDPRIVATESHAREDNEWCOPYPHASEINCEDFNOCEDFDPLSUBSETFULLAPIJVMCLASS( value)JVMPROFILE( value)OPERATION( value)JVMNOJVM

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.

You cannot specify PHASEIN 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.

You cannot specify NEWCOPY for a PROGRAM resource that was defined and installed in a CICS bundle. To implement a new version of the program, replace the old version of the CICS bundle with an updated version. If the CICS bundle was deployed as part of an application or with an application binding, update the whole application.

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 these conditions apply:
  • The program resource is itself bundle defined.
  • The program resource has been modified by the install of a bundle that modifies the program to be used as an entry point.
  • The program resource is a CICS program (program resources that begin with DFH or with EYU).

To notify CICS that a program is no longer to be used as an entry point, specify a value of a space character for the OPERATION option.

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.

You cannot specify PHASEIN 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.

You cannot specify PHASEIN for a PROGRAM resource that was defined and installed in a CICS bundle. To implement a new version of the program, replace the old version of the CICS bundle with an updated version. If the CICS bundle was deployed as part of an application or with an application binding, update the whole application.

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.