5

RESOURCE

DEFINITION

ONLINE

Access Computing Education

 5

OBJECTIVES

Access Computing Education

5.1 WHAT IS RESOURCE DEFINITION ONLINE

RDO allows CICS and User resources to be defined online

For the User :

• Transactions
• Programs
• Mapsets
• Files

Each successive CICS release has delivered more online definitions

Access Computing Education

5.2 RDO COMPONENTS

The components of RDO :

• CICS System definition dataset

• RDO Transactions
 CEDA, CEDB, CEDC
• Batch utility DFHCSDUP
• RDO logging
• Global Catalog

Access Computing Education

5.2 RDO COMPONENTS

Most of the resources a system needs can be defined online :

In addition to the application resources, the following can be defined :
Connections Sessions
Terminals Consoles
Files Lsrpools
Transient Data Qs Journals
Partners DB2 Resources
Library TCP/IP
CICS Web Services Temporary Storage Profiles

Access Computing Education

5.3 THE STRUCTURE OF RDO

The CSD is defined in the System Initialisation Table

There a number of SIT options to be considered

How the CSD can be shared among two or more CICS

Limitations on VSAM Shareoptions

The name is DFHCSD

Access Computing Education

5.3 THE STRUCTURE OF RDO

Each resource must be a member of a group

Each group may be added to a List

Each CICS can support up to 4 lists

They are read on a COLD Start

CICS will indicate which List is currently being accessed

Access Computing Education
5.3 THE STRUCTURE OF RDO

Three RDO transactions :

• CEDA
• CEDB
• CEDC

CEDC should be considered for everyone

Access Computing Education

5.4 THE RDO TRANSACTIONS

CEDA is the most powerful

Resources can be defined, displayed, copied, altered, cross checked

Groups can be merged, copied, moved, locked

Lists can be copied

Install changes the running system

Access Computing Education
5.4 THE RDO TRANSACTIONS

Userdefine allows the default options to be changed

Lock and Unlock requires the Opid of the user

View is browse only

Access Computing Education

5.5 DEFINING RDO

The CSD is defined online with the dataset name

It is defined as CLOSED and ENABLED

In this case CICS will invoke dynamic allocation

Alternatively, the CSD can be defined in the CICS JCL

//DFHCSD DD DSN=CICS.DFHCSD,DISP=SHR

Access Computing Education

5.5 DEFINING RDO

Changes to the CSD are logged for Auditing

There many logs and they can be browsed online via the CICSlog

They are separated for different User groups

These logging destinations must be defined in the DCT

Access Computing Education

5.5 DEFINING RDO

A new CSD must be initialised

Batch utility DFHCSDUP performs this

One list is created DFHLIST

No resources in the supplied groups can be changed

Userlists can be created

Access Computing Education

5.5 DEFINING RDO

Two methods to inform CICS of a new resource :

• Install option of CEDA

• A COLD start

An individual resource or an entire group can be Installed

Access Computing Education

5.5 DEFINING RDO

Some tables may need to be Migrated onto the CSD

Batch utility DFHCSD can be run with the MIGRATE option

The Migrate process reads the Load Library

Tables must be assembled with the Migrate option on the Initial

statement

Access Computing Education

5.6 MIGRATING TABLES TO RDO

DFHDCT TYPE=(INITIAL,MIGRATE)
entries
SDSCI ASSEMBLED
&
EXTRA LINK-EDIT
INTRA TABLE
LOADLIB
INDIRECT DFHDCTxx

// EXEC PGM=DFHCSDUP
//DFHCSD DD DSN=
//SYSIN DD *
MIGRATE TABLE(tablename)
TOGROUP(groupname)

DFHCSD
GROUP
DFHDCTxx

Access Computing Education

5.7 THE CEDA TRANSACTION

_
ENTER ONE OF THE FOLLOWING
Add
Alter
Append
Check
Copy
DEFine
DELete
Display
Expand
Install
Lock
Move
REMove
REName
Unlock
Userdefine
View

SYSID = CICS APPLID = DBDCCICS

PF1 HELP 3 END 6 CRSR 9 MSG 12
CNCL

Access Computing Education

5.7 THE CEDA TRANSACTION

_
DEFINE
ENTER ONE OF THE FOLLOWING
CONnection PROCesstype
CORbaserver PROFile
DB2Conn PROGram
DB2Entry Requestmode
DB2Tran Sessions
DJar TCpipservic
DOctemplate TDqueue
Enqmodel TErminal
File TRANClass
Ipconn TRANSaction
Journalmodel TSmodel
LIbrary TYpeterm
LSrpool Urimap
Mapset Webservice
PARTItionset
PARTNer
PIpeline

SYSID = CICS APPLID = DBDCCICS

PF1 HELP 3 END 6 CRSR 9 MSG 12
CNCL

Access Computing Education

5.7 THE CEDA TRANSACTION

DEFINE PROG(PROGA) GROUP(GENLEDGR)

OVERTYPE
_ TO MODIFY CICS RELEASE = 0720
CEDA DEFine
PROGram ==> PROGA
Group ==> GENLEDGR
Description ==> ………………………………………………………...
Language ==> Cobol 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
Cedf ==> Yes Yes|No
Datalocation ==> Below Below|Any
EXECKey ==> User User|CICS
COncurrency ==> Quasirent Quasirent | Threadsafe
REMOTE ATTRIBUTES
REMOTESystem ==>
REMOTEName ==>
Transid ==>
EXECUtionset ==> Fullapi|Dplsubset

I New Group GENLEDGR Created

SYSID = CICS APPLID = DBDCCICS
PF1 HELP 3 END 6 CRSR 9 MSG 12
CNCL

Access Computing Education

5.7 THE CEDA TRANSACTION

DEFINE TRANSACTION(ABCD) PROG(PROGA) GROUP(GENLEDGR)

OVERTYPE TO MODIFY CICS RELEASE = 0720
CEDA DEFine
TRANSaction ==> ABCD
Group ==> GENLEDGR
Description ==> ………………………………………………………...
PROGram ==> PROGA
TWasize ==> 0 0|32767
PROFile ==> DFHCICST
PArtition ==>
Status ==> Enabled Enabled|Disabled
PRIMedsize ==> 00000 0|65520
TASKDATAKey ==> User User|CICS
TASKDATALoc ==> Below Below|Any
REMOTE ATTRIBUTES
Dynamic ==> No No|Yes
REMOTESystem ==>
REMOTEName ==>
TRprof ==>
Localq ==>
SCHEDULING
Priority ==> 0|255
+Tclass ==> No No|1-10
SYSID = CICS APPLID = DBDCCICS
PF1 HELP 3 END 6 CRSR 7 FORW 8 BACK 9 MSG 12 CNCL

Access Computing Education

5.7 THE CEDA TRANSACTION

DEFINE TRANSACTION(ABCD) PROG(PROGA) GROUP(GENLEDGR)

OVERTYPE TO MODIFY CICS RELEASE = 0720
+ ALIASES
Alias ==>
TASKReq ==>
XTRanid ==>
TPName ==>
XTPname ==>
RECOVERY
DTimout ==> No No|1-7000
Indoubt ==> Backout Backout|Commit|Wait
RESTart ==> No No|Yes
SPurge ==> No No|Yes
TPurge ==> No No|Yes
Dump ==> Yes Yes|No
TRAce ==> Yes Yes|No
SECURITY
RESSec ==> No No|Yes
Cmdsec ==> No No|Yes
EXTsec ==> No No|Yes
TRANsec ==> 01 1-64
Rsl : 00

SYSID = CICS APPLID = DBDCCICS

PF1 HELP 3 END 6 CRSR 7 FORW 8 BACK 9 MSG 12 CNCL

Access Computing Education

5.7 THE CEDA TRANSACTION

DEFINE FILE (VSAMFILE) GROUP(GENLEDGR)

OVERTYPE TO MODIFY CICS RELEASE = 0720
CEDA DEFine
File ==> VSAMFILE
Group ==> GENLEDGR
Description ==> ………………………………………………………...
VSAM PARAMETERS
DSName ==>
Password ==> Password Not Specified
Lsrpoolid ==> 1 1-8|None
DNSHaring ==> Allreqs Allreqs|Modifyreqs
STRings ==> 001 1-255
Nsrgroup ==>
REMOTE ATTRIBUTES
REMOTESystem ==>
REMOTEName ==>
RECORDSize ==> 1-32767
Keylength ==> 1-255
INITIAL STATUS
Status ==> Enabled Enabled|Disabled|Unenabled
Opentime ==> Firstref Firstref|Startup
+Disposition ==> Share Share|Old

SYSID = CICS APPLID = DBDCCICS

PF1 HELP 3 END 6 CRSR 7 FORW 8 BACK 9 MSG 12 CNCL

Access Computing Education

5.7 THE CEDA TRANSACTION

DEFINE FILE (VSAMFILE) GROUP(GENLEDGR)

OVERTYPE TO MODIFY CICS RELEASE = 0720

+BUFFERS
Databuffers ==> 00002 2-32767
Indexbuffers ==> 00001 1-32767
DATATABLE PARAMETERS
Table ==> No No|CICS|User
Maxnumrecs ==> 16-16777215
CFDATABLE PARAMETERS
cfdtpool ==>
TABLEName ==>
UPDATEModel ==> Locking Contention | Locking
Load ==> No No | Yes
DATA FORMAT
RECORDFormat ==> V V|F
OPERATIONS
Add ==> No No|Yes
Browse ==> No No|Yes
Delete ==> No No|Yes
Read ==> Yes Yes|No
+Update ==> No No|Yes

SYSID = CICS APPLID = DBDCCICS

PF1 HELP 3 END 6 CRSR 7 FORW 8 BACK 9 MSG 12 CNCL

Access Computing Education

5.7 THE CEDA TRANSACTION

DEFINE FILE (VSAMFILE) GROUP(GENLEDGR)

OVERTYPE TO MODIFY CICS RELEASE = 0720

+AUTO JOURNALLING
Journal ==> No No|1-99
JNLRead ==> None None|Updateonly|Readonly|All
JNLSYNCRead ==> No No|Yes
JNLUpdate ==> No No|Yes
JNLAdd ==> None None|Before|After|All
JNLSYNCWrite ==> Yes Yes|No
RECOVERY PARAMETERS
RECOVery ==> None None|Backoutonly|All
Fwdrecovlog ==> No No|1-99
BAckuptype ==> Static Static|Dynamic
SECURITY
RESsecnum : 00

SYSID = CICS APPLID = DBDCCICS

PF1 HELP 3 END 6 CRSR 7 FORW 8 BACK 9 MSG 12 CNCL

Access Computing Education

5.7 THE CEDA TRANSACTION

ADD
_ GROUP(GENLEDGR) LIST(USERLIST)
ENTER COMMANDS
Group GENLEDGR
List USERLIST

I ADD SUCCESSFUL
SYSID = CICS APPLID = DBDCCICS
PF1 HELP 3 END 6 CRSR 9 MSG 12
CNCL

Access Computing Education

5.7 THE CEDA TRANSACTION

EXPAND LIST(USERLIST)
_
ENTER COMMANDS
NAME TYPE LIST DATE TIME
APPLPROG GROUP USERLIST 07/04/19 16.21.50
ACCPAYB GROUP USERLIST 07/04/19 13.30.12
GENLEDGR GROUP USERLIST 07/04/19 12.20.34

RESULTS : 1 To 3 of 3 SYSID = CICS APPLID = DBDCCICS

PF1 HELP 3 END 6 CRSR 9 MSG 12
CNCL

Access Computing Education

5.7 THE CEDA TRANSACTION

_
EXPAND GROUP(GENLEDGR)
ENTER COMMANDS
NAME TYPE GROUP DATE TIME
PROGA PROGRAM GENLEDGR _ 07/04/19 15.40.15
ABCD TRANSACTION GENLEDGR 07/04/19 15.42.09

RESULTS : 1 To 2 of 2
SYSID = CICS APPLID = DBDCCICS
PF1 HELP 3 END 6 CRSR 9 MSG 12
CNCL

Access Computing Education

5.7 THE CEDA TRANSACTION

_
DEFINE LIBRARY
ENTER COMMANDS
OVERTYPE TO MODIFY CICS RELEASE = 0720
CEDA DEFine LIbrary( )
LIbrary ==> APPLICATION.LOADLIB
Group ==> CSDGROUP
DEScription ==>
Ranking ==> 1-9 | 11-99
CRitical ==> No No | Yes
Status ==> Enabled Enabled | Disabled
DATA SET NAMES
DSNAME01 ==>
DSNAME02 ==>
DSNAME03 ==>
DSNAME04 ==>
DSNAME05 ==>
DSNAME06 ==>
DSNAME07 ==>
DSNAME08 ==>
DSNAME09 ==>
+ DSNAME10 ==>
MESSAGES: 2 SEVERE
SYSID=CICS APPLID=CICSTS52

PF 1 HELP 2 COM 3 END 6 CRSR 7 SBH 8 SFH 9 MSG 10 SB 11 SF 12

CNCL

Access Computing Education

5.7 THE CEDA TRANSACTION

CHECK searches for duplicate names

USERDEFINE can change defaults

There is no facility to explicitly define or delete a Group or List

Access Computing Education

5.8 RDO BATCH UTILITY

The batch utility DFHCSDUP enables the user to perform most

functions online

Many Production environments prefer this as it gives a hardcopy

listing of what has been actioned

The List command can list a variety of resources, groups and lists

The Extract command is good if the user has developed or used one
of the supplied programs for listing the CSD

Access Computing Education

5.8 RDO BATCH UTILITY

DFHCSDUP has many options

It does not support the INSTALL option

This is for CEDA only

The INITIALISE option should be run only once on a new CSD

Access Computing Education

5.8 RDO BATCH UTILITY

Once a new CSD has been Initialised, a number of supplied groups

will exist, and a new List will be created

The List DFHLIST

Resources in these groups can only be changed through the

UPGRADE process when maintenance is applied

Access Computing Education

5.8 RDO BATCH UTILITY

DFHCSDUP can only Write to a CSD that is not opened for Write
mode in CICS

The Parm field can define this type of access

DFHCSDUP can be used to copy Groups from another CSD

Access Computing Education