The CEDA USERDEFINE command

Use the CEDA USERDEFINE command to create a new resource definition on the CSD with user-defined default attributes.

Syntax

Read syntax diagramSkip visual syntax diagram
>>-CEDA--USerdefine--+-Atomservice(name)--+--Group(groupname)--->
                     +-Bundle(name)-------+                     
                     +-CONnection(name)---+                     
                     +-CORbaserver(name)--+                     
                     +-DB2Conn(name)------+                     
                     +-DB2Entry(name)-----+                     
                     +-DB2Tran(name)------+                     
                     +-DJar(name)---------+                     
                     +-DOctemplate(name)--+                     
                     +-Enqmodel(name)-----+                     
                     +-File(name)---------+                     
                     +-Ipconn(name)-------+                     
                     +-JOurnalmodel(name)-+                     
                     +-JVmserver(name)----+                     
                     +-LIbrary(name)------+                     
                     +-LSRpool(name)------+                     
                     +-MApset(name)-------+                     
                     +-MQconn(name)-------+                     
                     +-PARTItionset(name)-+                     
                     +-PARTNer(name)------+                     
                     +-PIpeline(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)-----+                     
                     +-Urimap(name)-------+                     
                     '-Webservice(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. Although every definition in the group has the same name (USER), each is unique because it defines a different resource type.

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.
  1. 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 ==> Any                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
  2. 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 ==> Any                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 ==> Any                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.



dfha4_userdefine.html | Timestamp icon Last updated: Monday, 5 June 2017