INQUIRE BUNDLEPART

Retrieve information about the resources that are contained in an installed BUNDLE resource.

INQUIRE BUNDLEPART

Read syntax diagramSkip visual syntax diagramINQUIRE BUNDLEPART( data-area)BUNDLE( data-value)AVAILSTATUS( cvda)ENABLESTATUS( cvda)METADATAFILE( data-area)PARTCLASS( cvda)PARTTYPE( data-area)

Conditions: END, ILLOGIC, INVREQ, NOTAUTH, NOTFND

This command is threadsafe.

For more information about the use of CVDAs, see CICS-value data areas (CVDAs).

Description

Use the INQUIRE BUNDLEPART command to return information about the resources that are contained in an installed BUNDLE resource. You can use the INQUIRE BUNDLEPART command only in browse mode.

Browsing

You can browse through all the resources that are installed in your region by a BUNDLE resource by using the browse options (START, NEXT, and END) on the INQUIRE BUNDLEPART command.

See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

Options

AVAILSTATUS(cvda)
Returns the availability status of the bundle part resource:
AVAILABLE
The bundle part resource is an application entry point, and it is available.
UNAVAILABLE
The bundle part resource is an application entry point, and it is not available.
NONE
The bundle part resource is not an application entry point.
BUNDLE(data-value)
Specify the 1 - 8 character name of the BUNDLE resource that you want to browse when using the START option.
BUNDLEPART(data-area)
Returns the 1 - 255 character name of a resource that is contained in the bundle.
ENABLESTATUS(cvda)
Returns the enablement status of the resource in the bundle:
ENABLED
The resource is ready for use.
DISABLED
The resource is not available.
ENABLING
The resource is being created as part of the BUNDLE resource installation.
DISABLING
The resource is being disabled.
DISCARDING
A DISCARD command has been issued for the BUNDLE resource. The resource in the bundle is disabled and is being discarded.
UNUSABLE
The resource cannot be used. To try to enable the resource, you must first discard the BUNDLE resource by issuing a DISABLE command followed by a DISCARD command.
METADATAFILE(data-area)
Returns the 1 - 255 character name of the file on z/OS® UNIX that describes the resource, as defined in the manifest. The value is an absolute path from the root of the bundle directory.
PARTCLASS(cvda)
Returns the class of the resource that is defined in the manifest. The following values are valid:
DEFINITION
The resource is defined as a definition in the manifest.
ENTRYPOINT
The resource is an entry point to an application.
EXPORT
The resource is defined as an export in the manifest. The resource is available to other services installed in the CICS® region.
IMPORT
The resource is defined as an import in the manifest. The resource is required by the bundle in the CICS region.
POLICYSCOPE
The resource is a policy scope for a policy.
OPERATION(data-area)
Returns the 1 - 64 character name of the application operation for which the resource is declared as an application entry point.
PARTTYPE(data-area)
Returns the 1 - 255 character resource type as a URI. For example, the XMLTRANSFORM resource has the URI http://www.ibm.com/xmlns/prod/cics/bundle/XMLTRANSFORM.

Conditions

END
RESP2 values:
2
There are no more resource definitions of this type.
ILLOGIC
RESP2 values:
1
A START command has been issued when a browse of BUNDLE resources is already in progress, or a NEXT or an END command has been issued when a browse of BUNDLE resources is not in progress.
INVREQ
RESP2 values:
8
A BUNDLE name must be specified on START BUNDLEPART.
NOTAUTH
RESP2 values:
100
The user associated with the issuing task is not authorized to use this command.
101
The user associated with the issuing task is not authorized to access the BUNDLE resource in the way required by this command.
NOTFND
RESP2 values:
3
The BUNDLE cannot be found.