CSD DEFINE

Create a new resource definition in the CSD.

CSD DEFINE

Read syntax diagramSkip visual syntax diagramCSDDEFINERESTYPE( cvda)ATOMSERVICEBUNDLECONNECTIONCORBASERVERDB2CONNDB2ENTRYDB2TRANDJARDOCTEMPLATEENQMODELFILEIPCONNJOURNALMODELJVMSERVERLIBRARYLSRPOOLMAPSETMQCONNPARTITIONSETPARTNERPIPELINEPROCESSTYPEPROFILEPROGRAMREQUESTMODELSESSIONSTCPIPSERVICETDQUEUETERMINALTRANCLASSTRANSACTIONTSMODELTYPETERMURIMAPWEBSERVICERESID( data-value)GROUP( data-value)ATTRIBUTES( data-value)ATTRLEN( data-value)NOCOMPATCOMPATMODE( cvda)COMPAT

Conditions: CSDERR, DUPRES, INVREQ, LENGERR, LOCKED, NOTAUTH

Description

The CSD DEFINE command creates a new resource definition on the CSD.

A syncpoint is implicit in CSD DEFINE processing, except when an exception condition is detected early in processing the command. Uncommitted changes to recoverable resources made up to that point in the task are committed if the command is successful, and rolled back if not.

Options

ATTRIBUTES(data-value)
Specifies the attributes of the new resource. Code the list of attributes as a single character string.
See The ATTRIBUTES option for general rules for specifying attributes.
See Resource definition for details about specific attributes.
ATTRLEN(data-value)
Specifies the length in bytes of the character string supplied in the ATTRIBUTES option as a fullword binary value.
GROUP(data-value)
Specifies the 8-character name of the group containing the resource definition.
RESID(data-value)
Specifies the 8-character name of the resource to be defined. Resource names such as TRANSACTION that are only four characters in length must be padded with four blanks and passed in an 8-character field.
RESTYPE(cvda)
Specifies the type of resource definition to be defined. CVDA values are the resource type names.
COMPATMODE(cvda)
Specifies whether obsolete attributes are allowed in the ATTRIBUTES string for this command. Specify one of the following CVDA values:
COMPAT
Obsolete resource attributes are allowed in the ATTRIBUTES string for this command.
NOCOMPAT
Obsolete resource attributes are not allowed in the ATTRIBUTES string for this command.
The default is NOCOMPAT.

Conditions

CSDERR
RESP2 values:
1
The CSD cannot be read.
2
The CSD is read only.
3
The CSD is full.
4
The CSD is being used by another CICS system and is not configured for sharing
5
Insufficient VSAM strings (CSDSTRNO system initialization parameter value) are available to run the EXEC CICS CSD command.
DUPRES
RESP2 values:
1
A resource of this name and type already exists in the specified group.
2
The specified group did not exist but because a list of the same name is already present in the CSD, the group could not be created.
INVREQ
RESP2 values:
1
The resource type specified for RESTYPE is not valid.
2
The GROUP option contains one or more characters that are not valid.
11
The value of COMPATMODE is not valid.
200
The command was run in a program defined with an EXECUTIONSET value of DPLSUBSET or in a program invoked from a remote system by a distributed program link without the SYNCONRETURN option.
n
The ATTRIBUTES string contains a syntax error or RESID contains a character that is not valid.
See RESP2 values for EXEC CICS CREATE and EXEC CICS CSD commands for information on RESP2 values.
LENGERR
RESP2 value:
1
The length specified in ATTRLEN is negative.
LOCKED
RESP2 values:
1
The specified group is locked to another user.
2
The group is IBM-protected.
NOTAUTH
RESP2 value:
100
The user associated with the issuing task is not authorized to use this command.