The CEDA USERDEFINE command

Create a new resource definition.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-CEDA--USerdefine--+-Connection(name)---+--Group(groupname)--->
                     +-CORbaserver(name)--+                     
                     +-DB2Conn(name)------+                     
                     +-DB2Entry(name)-----+                     
                     +-DB2Tran(name)------+                     
                     +-DJar(name)---------+                     
                     +-DOctemplate(name)--+                     
                     +-Enqmodel(name)-----+                     
                     +-File(name)---------+                     
                     +-Journalmodel(name)-+                     
                     +-Lsrpool(name)------+                     
                     +-Mapset(name)-------+                     
                     +-PARTItionset(name)-+                     
                     +-PARTNer(name)------+                     
                     +-PROCesstype(name)--+                     
                     +-PROFile(name)------+                     
                     +-PROGram(name)------+                     
                     +-Requestmodel(name)-+                     
                     +-Sessions(name)-----+                     
                     +-TCpipservice(name)-+                     
                     +-TDqueue(name)------+                     
                     +-TErminal(name)-----+                     
                     +-TRANClass(name)----+                     
                     +-TRANSaction(name)--+                     
                     +-TSmodel(name)------+                     
                     '-TYpeterm(name)-----'                     

>--attribute list(newvalue)------------------------------------><

Description

USERDEFINE is an alternative to the DEFINE command. Instead of using CICS®-supplied default values, USERDEFINE uses your own defaults. Otherwise it operates in exactly the same way as DEFINE.

To set up your own defaults, use DEFINE to create a dummy resource definition named USER in a group named USERDEF. Each dummy resource definition must be complete (for example, a transaction definition must name a program definition, even though you always supply a program name when you USERDEFINE a transaction). You need not install the dummy resource definitions before using USERDEFINE.

Do this for each type of resource for which you want to set default values. Each of them is named USER, but this does not matter because the fact that they are definitions of different resource types makes them unique.

So you could have the following resources in your USERDEF group:
  • CONNECTION(USER)
  • CORBASERVER(USER)
  • DB2CONN(USER)
  • DB2ENTRY(USER)
  • DB2TRAN(USER)
  • DJAR(USER)
  • DOCTEMPLATE(USER)
  • ENQMODEL(USER)
  • FILE(USER)
  • JOURNALMODEL(USER)
  • LSRPOOL(USER)
  • MAPSET(USER)
  • PARTITIONSET(USER)
  • PARTNER(USER)
  • PROCESSTYPE(USER)
  • PROFILE(USER)
  • PROGRAM(USER)
  • REQUESTMODEL(USER)
  • SESSIONS(USER)
  • TCPIPSERVICE(USER)
  • TDQUEUE(USER)
  • TERMINAL(USER)
  • TRANCLASS(USER)
  • TRANSACTION(USER)
  • TSMODEL(USER)
  • TYPETERM(USER).

This example is reviewed in the 'Examples' section for this command.

Options

Attribute list
The attribute list depends on the resource type being defined; some resources have attributes that must be included in the definition. Attributes that you do not specify are given default values.
Group(groupname)
The name of the group to be defined.

Examples

Assembler programmers at an installation have created a dummy program definition called USER with Assembler as the default language. They use USERDEFINE to define their programs to CICS.

First you must define a program called USER in group USERDEF. You could do this with the command:
CEDA DEFINE PROGRAM(USER) GROUP(USERDEF)
The following figure shows the panel you would see as a result of this command:
  DEFINE PROGRAM(USER)
GROUP(USERDEF)            CICS RELEASE = 0620
  OVERTYPE TO MODIFY
   CEDA  DEFine
    PROGram        : USER
    Group          : USERDEF
    DEscription  ==>
    Language     ==>                    CObol ∨ Assembler ∨ Le370 ∨ C ∨ Pli
    RELoad       ==> No                 No ∨ Yes
    RESident     ==> No                 No ∨ Yes
    USAge        ==> Normal             Normal ∨ Transient
    USElpacopy   ==> No                 No ∨ Yes
    Status       ==> Enabled            Enabled ∨ Disabled
    RSl            : 00                 0-24 ∨ Public
    Cedf         ==> Yes                Yes ∨ No
    DAtalocation ==> Below              Below ∨ Any
 I New group USERDEF created
                                                 SYSID=ABCD    APPLID=DBDCCICS
   DEFINE SUCCESSFUL                      TIME:  11.24.39   DATE:  97.359
 PF 1 HELP 2 COM 3 END            6 CRSR 7 SBH 8 SFH 9 MSG 10 SB 11 SF 12 CNCL
Type in ASSEMBLER as the LANGUAGE option and press ENTER:
  OVERTYPE TO MODIFY
   CEDA  USerdefine
    PROGram        : USER
    Group          : USERDEF
    DEscription  ==>
    Language     ==> Assembler          CObol ∨ Assembler ∨ Le370 ∨ C ∨ Pli
    RELoad       ==> No                 No ∨ Yes
    RESident     ==> No                 No ∨ Yes
    USAge        ==> Normal             Normal ∨ Transient
    USElpacopy   ==> No                 No ∨ Yes
    Status       ==> Enabled            Enabled ∨ Disabled
    RSl            : 00                 0-24 ∨ Public
    Cedf         ==> Yes                Yes ∨ No
    DAtalocation ==> Below              Below ∨ Any
 
 
 
                                                 SYSID=ABCD    APPLID=DBDCCICS
   DEFINE SUCCESSFUL                      TIME:  11.24.41   DATE:  97.359
 PF 1 HELP 2 COM 3 END            6 CRSR 7 SBH 8 SFH 9 MSG 10 SB 11 SF 12 CNCL
Now, each time you want to define a new program, you can use the USERDEFINE command to get the default value ASSEMBLER automatically. So, if you want to define a new program P2 in group GRP you enter the command:
CEDA USERDEFINE PROGRAM(P2) GROUP(GRP)
The following figure shows the panel resulting from this command.
  USERDEFINE PROGRAM(P2)
GROUP(GRP)
  OVERTYPE TO MODIFY
   CEDA  USerdefine
    PROGram        : P2
    Group          : GRP
    DEscription  ==>
    Language     ==> Assembler          CObol ∨ Assembler ∨ Le370 ∨ C ∨ Pli
    RELoad       ==> No                 No ∨ Yes
    RESident     ==> No                 No ∨ Yes
    USAge        ==> Normal             Normal ∨ Transient
    USElpacopy   ==> No                 No ∨ Yes
    Status       ==> Enabled            Enabled ∨ Disabled
    RSl            : 00                 0-24 ∨ Public
    Cedf         ==> Yes                Yes ∨ No
    DAtalocation ==> Below              Below ∨ Any
                                                               APPLID=DBDCCICS
   USERDEFINE SUCCESSFUL                  TIME:  11.25.48   DATE:  97.359
 PF 1 HELP 2 COM 3 END            6 CRSR 7 SBH 8 SFH 9 MSG 10 SB 11 SF 12 CNCL

You see that the ASSEMBLER option has appeared for the LANGUAGE attribute. You can overtype the option values on this panel to complete the definition just as you can with the DEFINE command panel.

After you have set up your own defaults in a USER resource definition, anyone using the USERDEFINE command for that resource type gets those default values.

By renaming your USER to something else and defining your own dummy resource definition, you can use your own default values. Normally, however, your installation probably agrees on default values for standardization reasons, and puts a LOCK on the USERDEF GROUP.