BUNDLE attributes

Describes the syntax and attributes of the BUNDLE resource.

BASESCOPE(value)

Specifies the 1 - 255 character string that defines the scope for a bundle. Use a uniform resource identifier (URI) where possible. Use the BASESCOPE attribute when you want to group similar bundles together or when you want to associate a CICS® bundle with a particular application that is running in a platform. The URI for an application 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 major, minor, and micro version of the application.

The default value is empty so that all BUNDLE resources install in the same scope. See Scoping of bundles for more information.

Acceptable characters: `A-Z a-z 0-9 $ @ # . / - _ % & ? ! : \| " = ¬ , ; < >`

BUNDLE(name)

Specifies the 1 - 8 character name of the BUNDLE.

Acceptable characters: `A-Z a-z 0-9 $ @ # . / - _ % & ? ! : \| " = ¬ , ; < >`

It is preferable not to use names that start with DFH because these characters are reserved for use by CICS for PROGRAM, FILE and JVMSERVER. CICS can delete or discard them and replace them with CICS resources when you upgrade or provide new function or fixes. For PROGRAM and FILE, the DFH limit is policed when you are creating in a bundle, and issues a warning when you are creating it online. For JVMSERVER, there is no DFH limit and no warning when you are creating in a bundle, or when you are creating it online.

BUNDLEDIR(zfsdirectory)

Specifies the 1 - 255 character fully qualified name of the root directory for the bundle on z/OS® UNIX. The first character must be /.

The value specified must be a valid name for a UNIX file: It must not contain imbedded space characters. It must not contain consecutive instances of the `/` character. It is case-sensitive. Acceptable characters: `A-Z a-z 0-9 . / _ # @ -`

The value specified must be a valid name for a UNIX file:

It must not contain imbedded space characters.
It must not contain consecutive instances of the / character.
It is case-sensitive.

Acceptable characters:

A-Z a-z 0-9 . / _ # @ -

DESCRIPTION(text)

In this field, you can provide a description of the resource that you are defining. The description text can be up to 58 characters in length. No restrictions apply to the characters that you can use. However, if you use parentheses, ensure that each left parenthesis has a matching right one. If you use the CREATE command, for each single apostrophe in the text code, use two apostrophes.

STATUS(ENABLED|DISABLED)

Specifies the initial status of the BUNDLE resource when it is installed.

ENABLED: The BUNDLE is available for use. CICS checks that all prerequisites for the bundle are present in the region and attempts to install and enable all of the required resources that are defined in the bundle.
DISABLED: The BUNDLE is not available for use. CICS does not check for prerequisites and installs, but does not enable, the resources that are defined in the bundle.