CEMT INQUIRE BUNDLE

Retrieve information about a BUNDLE resource.

In the CICS Explorer, the Bundles operations view provides a functional equivalent to this command.

The resource signature

You can use this command to display the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.

Input

Press the Clear key to clear the screen and then enter CEMT INQUIRE BUNDLE to obtain information about one or more bundles that are installed in the CICS® region.

CEMT INQUIRE BUNDLE

Displayed fields

AVAILSTATUS(value)

Displays the availability status of the bundle. The possible values are as follows:

AVAILABLE: Callers can access all the resources identified in the CICS bundle as application entry points.
UNAVAILABLE: Callers cannot access any of the resources identified in the CICS bundle as application entry points.
SOMEAVAIL: Some application entry points are available and some are unavailable.
NOTAPPLIC: The bundle does not contain any statements of application entry points.

BASESCOPE(value)

Displays the URI that defines the root namespace for the contents of the bundle.

If the bundle was installed in a platform, the field displays a URI that describes the platform and application in which the bundle is deployed. The URI has the following format:

cicsapplication://Platform/ApplicationID/MajorVersion/MinorVersion/MicroVersion

Platform is the name of the platform in which the application is running, ApplicationID is the ID of the application bundle, followed by the version of the application.

BUNDLEDIR(directory)

Displays the directory on z/OS® UNIX where the bundle is deployed.

BUNDLEID(value)

Displays the ID of the bundle, if specified in the bundle manifest.

CHANGEAGENT(value)

Displays a value that identifies the agent that made the last change to the resource definition. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:

CREATESPI: The resource definition was last changed by an EXEC CICS CREATE command.
CSDAPI: The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
CSDBATCH: The resource definition was last changed by a DFHCSDUP job.
DREPAPI: The resource definition was last changed by a CICSPlex SM BAS API command.

CHANGEAGREL(value)

Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.

CHANGETIME(date time)

Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

CHANGEUSRID(value)

Displays the 8-character user ID that ran the change agent.

DEFINESOURCE(value)

Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.

DEFINETIME(date time)

Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

ENABLEDCOUNT(value)

Displays the current number of resources and entry points that were dynamically created by the bundle and are enabled in the CICS region.

ENABLESTATUS(value)

Displays the overall status of the bundle. The possible values are as follows:

ENABLING: The bundle is being initialized. It is creating and enabling the resources that are defined in the bundle manifest file.
ENABLED: The bundle is enabled for use.
DISABLING: The bundle is quiescing before entering DISABLED state. The bundle disables any resources that it enabled.
DISABLED: The bundle is disabled.
DISCARDING: A DISCARD command was issued for the bundle. The bundle is quiescing before being discarded. The bundle discards any resources that it disabled.

INSTALLAGENT(value)

Displays a value that identifies the agent that installed the resource. You cannot use CEMT to filter on some of these values because they are duplicated. The possible values are as follows:

CLOUD: The resource was installed by an application or platform deployment.
CREATESPI: The resource was installed by an EXEC CICS CREATE command.
CSDAPI: The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.
GRPLIST: The resource was installed by GRPLIST INSTALL.

INSTALLTIME(date time)

Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.

INSTALLUSRID(value)

Displays the 8-character user ID that installed the resource.

MAJORVERSION(value)

Displays the major version number of the bundle. If no version is specified in the bundle, 0 is displayed.

MICROVERSION(value)

Displays the micro version number of the bundle. If no version is specified in the bundle, 0 is displayed.

MINORVERSION(value)

Displays the minor version number of the bundle. If no version is specified in the bundle, 0 is displayed.

PARTCOUNT(value)

Displays the total number of imports, exports, entry points, and definition statements that are defined in the bundle manifest.

TARGETCOUNT(value)

Displays the total number of dynamically created resources and entry points in the bundle. CICS automatically enables the BUNDLE resource when all of the dynamically created resources are in an enabled state.