INQUIRE BUNDLEPART
Retrieve information about the resources that are contained in an installed BUNDLE resource.
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 is in an unusable state.
- 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
https://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.