Create a new resource definition.
>>-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)------------------------------------><
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.
This example is reviewed in the 'Examples' section for this command.
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.
CEDA DEFINE PROGRAM(USER) GROUP(USERDEF)
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
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
CEDA USERDEFINE PROGRAM(P2) GROUP(GRP)
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.