CREATE BUNDLE
Define a BUNDLE resource in the local CICS region.
Conditions: INVREQ, LENGERR, NOTAUTH
Note to COBOL programmers: In
the syntax above, you must use ATTRIBUTES(data-area) instead
of ATTRIBUTES(data-value).
Description
The CREATE BUNDLE command installs a BUNDLE definition with the attributes specified on the command. It does not use a resource definition stored in the CSD. If there is already a BUNDLE with the name that you specify in the local CICS region, and the existing BUNDLE is disabled, the new definition replaces the old one; if an existing BUNDLE is not disabled, the CREATE command fails.
Options
- ATTRIBUTES(data-value)
- Specifies the attributes of the BUNDLE being added. The list of attributes must be coded as a single character string using the syntax shown in BUNDLE attributes. See The ATTRIBUTES option for general rules for specifying attributes. See BUNDLE definition attributes for details about specific attributes.
- ATTRLEN(data-value)
- Specifies the length in bytes of the character string supplied in the ATTRIBUTES option, as a halfword binary value. The length must not exceed 32 767 bytes.
- BUNDLE(data-value)
- Specifies the 8-character name of the BUNDLE definition to be added to the CICS region.
- LOGMESSAGE(cvda)
- Specifies whether CICS logs the attributes used for the resource that
is created. CVDA values are as follows:
- LOG
- The resource attributes are logged to the CSDL transient data queue.
- NOLOG
- The resource attributes are not logged.
Conditions
- INVREQ
- RESP2 values:
- n
- The ATTRIBUTES string contains a syntax error, or an error occurred during either the discard or resource definition phase of the processing. The RESP2 value is associated with a message written to the transient data queue CSMT, which identifies more precisely the nature of the error.
- 612
- Installation of the BUNDLE definition failed because the definition already exists.
- 632
- Installation of BUNDLE resource resource failed because the manifest is not valid.
- 633
- Installation of BUNDLE resource resource failed because the resource had no manifest.
- 686
- Installation of the BUNDLE resource failed because an unexpected resource error occurred.
- 688
- Installation of BUNDLE resource resource failed because the resource already exists.
- LENGERR
- RESP2 values:
- 1
- The length that you have specified in ATTRLEN is negative.
- 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 this particular resource in the way required by this command.