The DFHCSDUP USERDEFINE command

Create new resource definitions using your own default values instead of the default values supplied by CICS.

USERDEFINE syntax

Description

The USERDEFINE command is an alternative to the DEFINE command. Instead of using the default values supplied by CICS, the USERDEFINE command uses your own default values to create a resource definition. Otherwise it operates in exactly the same way as the DEFINE command.

To set up your own default values for the USERDEFINE command, use the normal DEFINE command to create resource definitions named USER in a group named USERDEF:

Create a resource definition named USER in the USERDEF group for each resource for which you want to provide default values. For example, if you want to provide default values for PROGRAM, TRANSACTION, and TCPIPSERVICE resource definitions, create the resource definitions PROGRAM(USER), TRANSACTION(USER), and TCPIPSERVICE(USER) in the USERDEF group. It does not matter that all the resource definitions in the USERDEF group are named USER; they are unique because they are different resource types. Any resource definitions in the USERDEF group that are not named USER are ignored by the USERDEFINE command.
In each resource definition in the USERDEF group, specify the default values that are to be applied when you use the USERDEFINE command to create a resource of that type. For example, if you want Assembler to be the default language in PROGRAM resource definitions created with the USERDEFINE command, issue the following DEFINE command to create the resource definition:
```
DEFINE PROGRAM(USER) GROUP(USERDEF) LANGUAGE(ASSEMBLER)
```
Each resource definition in the USERDEF group must be a complete, valid resource definition. For example, a transaction definition must name a program definition, even if you always supply a program name when you use the USERDEFINE command to define a transaction.
You do not have to install the resource definitions in the USERDEF group.

When you have created resource definitions in the USERDEF group, you can use the USERDEFINE command to define those types of resources, and the default values that you set up are used in the resource definitions. For example, if you have created a PROGRAM resource definition in the USERDEF group that specifies LANGUAGE(ASSEMBLER), the following command creates a resource definition for program P2 in group GRP and specifies Assembler as the language:

USERDEFINE PROGRAM(P2) GROUP(GRP)

Options

Attribute list(value): The attribute list depends on the resource type that is being defined; some resources have attributes that must be included in the definition. For a description of the attributes and default values of each resource type, see RDO resources. Attributes that you do not specify are given default values.
Group(groupname): Specifies the name of the group that will contain the resource definition to be created. Do not use a generic group name. If you specify the name of a group which does not already exist, the group is created.
Resource(name): Specifies the name of the resource you want to define. Do not use a generic resource name. The resource option must always be the first operand of the USERDEFINE command.