Changes to CEMT

Obsolete CEMT commands and options

Table 4 shows those commands and options that are obsolete.

Table 4. Obsolete CEMT commands and options
CEMT command Option Comment
INQUIRE CORBASERVER
PORT
SSLPORT
SSLTYPE
These port-related options, introduced with the new CORBASERVER command in CICS® TS 2.1, are no longer required, because CICS now obtains TCP/IP port information from the TCPIPSERVICE resource definition used by the CorbaServer.
INQUIRE DISPATCHER
ACTHPTCBS
MAXHPTCBS
ACTHPTCBS displayed the number of H8 mode open TCBs that were active, and MAXHPTCBS displayed the number that CICS was allowed to attach. H8 mode open TCBs no longer exist.
INQUIRE PROGRAM
HOTPOOLING
HOTPOOL
NOTHOTPOOL
The values Hotpool and Nothotpool were used to show whether or not the Java™ program object was to be run in a preinitialized Language Environment® enclave.
INQUIRE REQUESTMODEL
OMGINTERFACE
OMGMODULE
OMGOPERATION
These options, which returned 31-character, 58-character, and 31-character values respectively, are obsolete and replaced by INTERFACE, MODULE, and OPERATION, each of which returns 255-character values. See Table 8 for details of all the changes to the REQUESTMODEL resource definition.
INQUIRE SYSTEM
ACTOPENTCBS
MAXOPENTCBS
These options are now included in the new INQUIRE DISPATCHER command, together with the other open TCB options.
SET DISPATCHER MAXHPTCBS This option used to specify the maximum number of H8 mode open TCBs that CICS was allowed to attach. H8 mode open TCBs no longer exist.
SET PROGRAM
HOTPOOL
NOTHOTPOOL
The values Hotpool and Nothotpool were used to show whether or not the Java program object was to be run in a preinitialized Language Environment enclave.

New CEMT commands

Table 5 shows new CICS transactions.

Table 5. New CEMT commands
CEMT command Explanation
DISCARD CORBASERVER Command added to discard installed CORBASERVER resource definitions.
DISCARD DJAR Command added to discard installed DJAR resource definitions, together with any associated beans.
DISCARD PIPELINE Use the command to remove a PIPELINE from the CICS system and the CICS catalog.
DISCARD URIMAP Use the command to remove a URIMAP from the CICS system and the CICS catalog.
DISCARD WEBSERVICE Use the command to remove a WEBSERVICE from the CICS system and the CICS catalog.
INQUIRE BEAN Command added to display information about a specified bean.
INQUIRE BRFACILITY Command added to display information about installed bridge facilities.
INQUIRE CLASSCACHE The INQUIRE CLASSCACHE command is added to give you information about the active shared class cache in the CICS region, and report the presence of any old shared class caches that are awaiting deletion.
INQUIRE CORBASERVER Command added to display information about installed CORBASERVER resource definitions in the CICS region.
INQUIRE DISPATCHER Command added to display CICS system information used by the CICS dispatcher. Note that this new command includes the ACTOPENTCBS and MAXOPENTCBS options that have been removed from INQUIRE SYSTEM.
INQUIRE DJAR Command added to display information about installed DJAR resource definitions in the CICS region.
INQUIRE HOST Use the command to retrieve information about a particular virtual HOST in the local CICS region.
INQUIRE JVM The INQUIRE JVM command is added to enable you to identify JVMs in a CICS region and get information about their status.
INQUIRE JVMPOOL Command added to display information about the pool of JVMs in the CICS region.
INQUIRE PIPELINE Use the command to retrieve information about an installed PIPELINE.
INQUIRE URIMAP Use the command to retrieve information about URIMAP resource definitions.
INQUIRE WEBSERVICE Use the command to retrieve information about an installed WEBSERVICE.
INQUIRE WORKREQUEST The INQUIRE WORKREQUEST command is added to enable you to track EJB tasks. You can:
  • determine which transactions are associated with a single request
  • correlate all transactions associated with a single request (for example, for accounting purposes)
PERFORM CLASSCACHE The PERFORM CLASSCACHE command is added to enable you to start and reload the shared class cache, or to phase out, purge or forcepurge the shared class cache and the worker JVMs associated with it. While you are performing one of these operations, you can also change the size of the shared class cache, the JVM profile that is used for the master JVM, or the autostart status of the shared class cache.
PERFORM CORBASERVER Command added to perform a specified action on the beans in a CORBASERVER resource definition. The action can be either PUBLISH or RETRACT.
PERFORM DJAR Command added to perform a specified action on an installed DJAR resource definition. The action can be either PUBLISH or RETRACT.
PERFORM PIPELINE Use the command to initiate a scan of the Web service binding directory that is specified in the WSBIND attribute of the PIPELINE definition.
SET BRFACILITY Command added to enable you to flag the bridge facility for deletion.
SET CLASSCACHE The SET CLASSCACHE command is added to enable you to set the status of autostart for the shared class cache.
SET CORBASERVER Command added to enable you to alter the time-out value of the session beans (SESSBEANTIME) in an installed CORBASERVER resource definition in the CICS region.
SET DISPATCHER Command added to enable you to alter the system values used by CICS dispatcher
SET HOST Use the command to Enable or disable a virtual HOST.
SET JVMPOOL Command added to enable you to enable or disable the JVM pool, or terminate it altogether.
SET PIPELINE Use the command to enable or disable a PIPELINE.
SET URIMAP Use the command to enable or disable a URIMAP definition, and apply or remove redirection for a URIMAP definition.
SET WEBSERVICE Use the command to set the validation status of a WEBSERVICE.
SET WORKREQUEST The SET WORKREQUEST command is added to enable you to track EJB tasks. You can:
  • determine which transactions are associated with a single request
  • correlate all transactions associated with a single request (for example, for accounting purposes)
  • purge selected work requests
.

For detailed information on all the new and changed CEMT transactions and options, see the CICS Supplied Transactions manual.

Changed CEMT commands

Table 6 shows those CEMT commands that have changed in some way.

Table 6. Changed CEMT commands
CEMT command Option Explanation
INQUIRE AUTOINSTALL
AIBRIDGE
The AIBRIDGE option is added to return a value indicating whether the autoinstall URM is called for bridge facilities.
INQUIRE CORBASERVER
AUTOPUBLISH
CLIENTCERT
DJARDIR
SSLUNAUTH
UNAUTH
ENABLESTATUS
These options display:
  • The status of autopublishing for enterprise beans
  • The 255-character name of the deployed JAR file directory
  • The names of the TCP/IP service definitions referenced by the CorbaServer (named by CLIENTCERT, SSLUNAUTH, and UNAUTH).
  • ENABLESTATUS displays a value indicating the current state of the CorbaServer (DISABLED, DISABLING, DISCARDING, ENABLED, or ENABLING). ENABLESTATUS replaces the STATE option, which is now obsolete.
INQUIRE DB2CONN
DB2GROUPID
RESYNCMEMBER
These options are added to display
  • The DB2® group ID if CICS is using the DB2 group attach facility
  • The resynchronization policy to be used for units of work awaiting resolution. The possible values are RESYNC or NORESYNC.
INQUIRE DISPATCHER
ACTSSLTCBS
ACTXPTCBS
MAXSSLTCBS and
MAXXPTCBS
are added
ACTSSLTCBS displays the number of S8 mode open TCBs that are active, and MAXSSLTCBS displays the number that CICS is allowed to attach.

ACTXPTCBS displays the number of X8 and X9 mode open TCBs that are active, and MAXXPTCBS displays the number that CICS is allowed to attach.

INQUIRE DOCTEMPLATE
HFSFILE
is added
HFSFILE returns the fully-qualified name of the z/OS® UNIX System Services HFS file where the template resides.
INQUIRE PROGRAM JVMPROFILE
LENV
The JVMPROFILE option is added to display name of the JVM profile for a Java program.

The LENV CVDA value for the RUNTIME option replaces the LE370 value. Its meaning is unchanged and the numeric value associated with this CVDA remains 377.

INQUIRE PROGRAM
APIST is added
RUNTIME has a new value

APIST displays the API attribute of the installed program definition. The values are:

CICSAPI
OPENAPI

The XPLINK value for the RUNTIME option means that the program is a C or C++ program which has been compiled using the XPLINK option.

INQUIRE REQUESTMODEL
BEANNAME
CORBASERVER
INTERFACE
INTFACETYPE
MODULE
OPERATION
TYPE
The REQUESTMODEL resource definition now supports both CORBA and EJB requests, and these new attributes are added to support this dual purpose definition. Note that INTERFACE, MODULE, and OPERATION replace the OMGINTERFACE, OMGMODULE, and OMGOPERATION equivalent options of CICS TS 1.3.
INQUIRE SYSTEM DEBUGTOOL Displays a value (DEBUG or NODEBUG) indicating whether debugging profiles will be used to select programs that will run under the control of a debugging tool.
INQUIRE SYSTEM FORCEQR has a revised description The description of FORCEQR, and its value FORCE are altered to limit its relevance to CICSAPI programs, because it does not apply to OPENAPI programs.
INQUIRE TASK BRFACILITY This option is added to return an 8-byte field containing the facilitytoken for the bridge facility in use by the task.
INQUIRE TCPIP
ACTSOCKETS
MAXSOCKETS
These options are added to return (1) the number of active sockets and (2) the maximum number of TCP/IP sockets that can be managed by the CICS region.
INQUIRE TCPIP
CRLPROFILE and
SSLCACHE
are added
CRLPROFILE displays the name of the profile that authorizes CICS to use the certificate revocation lists on an LDAP server.

SSLCACHE .displays whether CICS is using local or sysplex caching of session ids. The values are:

CICS
SYSPLEX

.

INQUIRE TCPIPSERVICE
ATTACHSEC
AUTHENTICATE
CERTIFICATE
DNSGROUP
DNSSTATUS
GROUPCRITICAL
These options are added to display (1) security information; (2) the 18-character DNS group name that the TCPIPSERVICE registers with WLM; (3) the current WLM/DNS status; and (4) whether the TCPIPSERVICE is a critical member of the DNS group.
INQUIRE TCPIPSERVICE MAXDATALEN is added MAXDATALEN displays the maximum length of data that may be received by CICS as an HTTP server.
INQUIRE TERMINAL | NETNAME NQNAME This option is added to display the 17-character network qualified name of the terminal.
INQUIRE TRANSACTION OTSTIMEOUT This option is added to display the time an OTS transaction in an EJB environment is allowed to run before the initiator takes a syncpoint (or rolls back the OTS transaction).
INQUIRE UOW OTSTID(value) This option is added to display the transaction identifier (TID) of the OTS transaction of which the UOW is part.
INQUIRE UOWLINK HOST(name) TYPE(IIOP) The HOST option is added to display the TCP/IP host name, used to refer to the participant an OTS transaction, when the TYPE option returns IIOP. IIOP is a new value on the TYPE option.
INQUIRE WORKREQUEST
WORKTYPE
has a new value.
There is a new value SOAP for the WORKTYPE option.
PERFORM CORBASERVER SCAN This option is added to enable you to scan the CorbaServer's deployed JAR file directory (also known as the pickup directory) for new or updated deployed JAR files.
PERFORM STATISTICS
CORBASERVER
JVMPOOL
REQUESTMODEL
TCPIP
These options are added to enable you to write statistics for the CORBASERVER, JVMPOOL, REQUESTMODEL, and TCPIP resource types to the SMF data
Start of changePERFORM STATISTICSEnd of change Start of changeBEAN, JVMPROFILE, JVMPROGRAMEnd of change Start of changeNew resource types for which statistics can be recorded.End of change
PERFORM STATISTICS
PIPELINE and
WEBSERVICE
are added.
SET AUTOINSTALL AIBRIDGE This option is added to enable you to define whether the autoinstall URM is called for bridge facilities.
SET CORBASERVER AUTOPUBLISH This option is added to allow you to set the enterprise beans autopublish option in a CorbaServer.
SET CORBASERVER
DISABLED
ENABLED
Specifies whether to enable or disable the CorbaServer.
SET DB2CONN
DB2GROUPID
RESYNCMEMBER
These options are added to allow you to set DB2 group ID and resynchronization policy for CICS DB2 group attach support.
SET DISPATCHER
MAXSSLTCBS
MAXXPTCBS
are added
MAXSSLTCBS displays the maximum number of S8 mode open TCBs that CICS is allowed to attach.

MAXXPTCBS specifies the maximum number of X8 and X9 mode open TCBs that CICS is allowed to attach.

SET JVMPOOL
TERMINATE
Deletes the shared class cache as well as the JVMs in the JVM pool.
SET PROGRAM
JVMPROFILE
For Java programs, this option specifies the 8-character name of a JVM profile that is to be used for the JVM in which the program runs. Any instances of this program that are currently running in a JVM with the old JVM profile are unaffected, and are allowed to finish running.
SET SYSTEM
DEBUG
NODEBUG
Specifies whether debugging profiles will be used to select programs that will run under the control of a debugging tool.
SET SYSTEM FORCEQR has a revised description The description of FORCEQR, and its value FORCE are altered to limit its relevance to CICSAPI programs, because it does not apply to OPENAPI programs.
SET TCPIP MAXSOCKETS This option is added to enable you to alter the maximum number of TCP/IP sockets allowed in the CICS region.
SET TCPIPSERVICE DNSSTATUS This option is added to enable you to alter the CICS DNS registration status.
SET TCPIPSERVICE MAXDATALEN is added MAXDATALEN specifies the maximum length of data that may be received by CICS as an HTTP server.
SET WORKREQUEST WORKTYPE There is a new value SOAP for the WORKTYPE option.
[[ Contents Previous Page | Next Page Index ]]