The CEDA INSTALL command

Use the CEDA INSTALL command to make the resource definitions in the named group or group list available to the active CICS® system.

Syntax

Read syntax diagramSkip visual syntax diagramCEDAInstallALl( name)Atomservice( name)Bundle( name)CONnection( name)CORbaserver( name)DB2Conn( name)DB2Entry( name)DB2Tran( name)DJar( name)DOctemplate( name)Enqmodel( name)File( name)Ipconn( name)JOurnalmodel( name)JVmserver( name)LIbrary( name)LSRpool( name)MApset( name)MQconn( name)PARTItionset( name)PARTNer( name)PIpeline( name)PROCesstype( name)PROFile( name)PROGram( name)Requestmodel( name)Sessions( name)TCpipservice( name)TDqueue( name)TErminal( name)TRANClass( name)TRANSaction( name)TSmodel( name)TYpeterm( name)Urimap( name)Webservice( name)Group( groupname)List( listname)

Description

You can use single-resource installation to install only the resources you require.

When applied to telecommunication and intercommunication resources, restrictions apply to the single-resource INSTALL command. The restrictions apply to resource definitions that are linked; for example, CONNECTION and SESSIONS definitions.

You can install the following resource types only as part of a group:
  • CONNECTION definitions, except a CONNECTION with ACCESSMETHOD(INDIRECT)
  • SESSIONS definitions
  • TERMINAL definitions for pipeline terminals that share the same POOL

If you want to use single-resource INSTALL for TERMINAL and related TYPETERM definitions, you must install the TYPETERM that is referred to by a TERMINAL definition before you install the TERMINAL definition.

The same restriction applies when installing groups containing TERMINAL and TYPETERM definitions; install the group containing the TYPETERM definition before you install the group containing the TERMINAL definition. Similarly, if you install a list that contains groups containing TERMINAL and TYPETERM definitions, the group containing the TYPETERM definition must be before the group containing the TERMINAL definition. Also, in a list containing groups of DB2® resource definitions (DB2CONN, DB2ENTRY, and DB2TRAN definitions), the DB2CONN must be defined in the first group in the list.

If you want to use single-resource install for ENQMODEL, note that ENQMODEL definitions usually have the default status of ENABLED, so the order of installing ENQMODELs must follow the rules for enabling ENQMODEL definitions. This means that the ENQMODEL definitions that form nested generic ENQnames must be enabled in sequence, from the most specific to the least specific, for example: ABCD* then ABC* then AB*.

If the named resource already exists in the active CICS system, the existing definition is replaced by the new one.

Replacement of an existing definition occurs only if it is not in use.

If the installation of one or more of the resources in the group or groups that are being installed fails because the resource is in use or for any other reason, the following actions occur:
  1. The installation process continues with the next resource in the group.
  2. When the group installation is complete, if the resource that failed was part of an installable set, all the resources in the installable set are backed out. Resources that were committed at the individual resource level are not backed out. For a list of the resource types that are committed as part of an installable set, see What happens when you use the INSTALL command.
  3. A message is displayed to indicate that the group has been only partially installed. A message is also produced on the message panel for each of the resources that failed to install, stating the reason for each failure. No messages are produced for those resources that have been backed out.

In addition, a message is written to the CEMT log, saying that the install completed with errors.

You can run the CEDA INSTALL from a console, using the MVS™ MODIFY command.

Options

Group(groupname)
Specifies the name of the group to be installed, or the name of the group that contains the resource to be installed. A generic group name is not accepted.
List(listname)
Specifies a list of groups to be installed, or a list of groups containing the resource to be installed. A generic list name is not accepted.
resource(name)
Specifies the type and name of the resource that you want to install.