FILEDEF Resource Table

A CICS® Definition that describes the physical and operational characteristics of a file.

The Primary key field for this resource class is NAME.

The Secondary key field for this resource class is DEFVER.

The Tertiary key field for this resource class is CSDGROUP.

The following actions are supported:

INSTALL: Install a File Definition.
The parameter data for the INSTALL action is described in Parameters for installing CICS definitions using BAS.

External resource name: CICSDefinitionFile
Length: 456
Usage: API or Batch Utility or WUI or CICS Management Client Interface
API view: No
CMAS context: No
SCOPE applies: No
Only query CMASs in workload: No
Object type: CICS Definition
Copybook identifier: EYUt3801

Table 1. Valid CPSM operations
Operations	Actions	Parameters	Required
GET		CICSSYS(value)	No
		CSDGROUP(value)	No
		RESGROUP(value)	No
CREATE		CSD	No
		RESGROUP(value)	No
UPDATE		CSD	No
REMOVE		CSD	No
PERFORM SET	INSTALL	FORCEINS(YES, NO)	No
		MODE(value)	No
		NOTIFY(NO, INACTIVE, RELEASE, FULL)	No
		OVERRIDE	No
		OVERTYPE(TARGET, RELATED, BOTH, NONE)	No
		RELATED(value)	No
		STATECHK(YES, NO)	No
		TARGET(value)	Yes
		USAGE(LOCAL, REMOTE)	Yes
	ADDTOGRP	RESGROUP(value)	Yes
	CSDINSTALL	None	N/A
	CSDCOPY	AS_RESOURCE(value)	No
		DUPACTION(DUPERROR, DUPNOREPLACE, DUPREPLACE)	No
		TO_CSDGROUP(value)	No

Table 2. FILEDEF FEEDBACK error codes
Value	Code	Description
1	FILEDEF_INV_DATA	Attribute data invalid
2	FILEDEF_REC_NOT_FOUND	Requested resource not found
4	FILEDEF_REC_EXISTS	Resource already exists
5	FILEDEF_REC_CHANGED	Resource definition already changed
6	FILEDEF_INV_RESTYPE	Invalid resource type
7	FILEDEF_INV_VER	Invalid resource version
11	FILEDEF_NON_MP	Maintenance point CMAS not available
12	FILEDEF_INV_CONTEXT	Context not found
13	FILEDEF_INCONSISTENT_SET	Inconsistent set condition
14	FILEDEF_INV_RESGROUP	Resource group not found
21	FILEDEF_INV_ACTION	Invalid action
22	FILEDEF_INV_RECADDR	Invalid record address
23	FILEDEF_INV_RECLEN	Invalid record length
24	FILEDEF_DIFF_VERSION	Different version
25	FILEDEF_EARLY_NAMELIST_END	Early name list end
26	FILEDEF_INV_NAMELIST	Invalid name list
27	FILEDEF_INV_NAME	Invalid name
28	FILEDEF_INV_MINNAME	Invalid minor name
29	FILEDEF_NOTIFY	Notify
30	FILEDEF_PARTIAL_INSTALL	Partial install
31	FILEDEF_NOTHING_INSTALLED	Nothing installed
32	FILEDEF_NO_TARGETS	No targets
33	FILEDEF_NO_RELATED	No related systems
34	FILEDEF_INV_TSCOPE	Invalid target scope
35	FILEDEF_INV_RSCOPE	Invalid related scope
36	FILEDEF_INV_USAGE	Invalid usage
37	FILEDEF_INV_MODE	Invalid mode
38	FILEDEF_INV_STATECHK	Invalid state check
39	FILEDEF_INV_FORCEINS	Invalid force install
40	FILEDEF_INV_NOTIFY	Invalid notify
41	FILEDEF_INV_OVERTYPE	Invalid override type
42	FILEDEF_INV_OVRBLOCK	Invalid override block
43	FILEDEF_INV_ORSTRING	Invalid override string
44	FILEDEF_INV_STRNGTERM	Invalid string term
45	FILEDEF_INV_EMBEDTERM	Invalid embedded terminator
46	FILEDEF_INV_ATTRIBUTE	Invalid attribute
47	FILEDEF_INV_LITERAL	Invalid literal
48	FILEDEF_INV_ORSTGNA	Invalid override string
49	FILEDEF_SCOPE_REQUIRED	Scope required
50	FILEDEF_USAGE_CONFLICT	Usage conflict
51	FILEDEF_NODEFS_SELECTED	No definitions selected
52	FILEDEF_MORE_THAN_1_RELSYS	More than one related system
53	FILEDEF_MISSING_RELSYSID	Missing related system identifier
54	FILEDEF_SCOPE_CONFLICT	Scope conflict
55	FILEDEF_INV_CSDGROUP	Invalid CSD group
56	FILEDEF_REC_NOT_REMOVED	Record not removed
57	FILEDEF_INV_RESOURCE	Invalid resource
58	FILEDEF_INV_CICS_RESTYPE	Invalid CICS restype
59	FILEDEF_PARTIAL_ACTION	Partial action
60	FILEDEF_NOTHING_ACTIONED	Nothing actioned
61	FILEDEF_INV_BOTHTOAS	TO_CSDGROUP and AS_RESOURCE are mutually exclusive
62	FILEDEF_INV_NOTTOAS	Either TO_CSDGROUP or AS_RESOURCE is required
63	FILEDEF_CSD_ERROR	CSD access error

Table 3. FILEDEF resource table attributes
Name	Datatype	Source	Len	Req	Sum	Set	Description	Default	Value Range	Get Invalid	Attr ID
ACCESSMETH	CVDAS	CPSM	4	Yes	LIKE	No	File access method	VSAM		E330+	47
ACCESSMETH Input/output valid values	ESDS, KSDS, RRDS, KEYED, BDAM, VSAM, NOTAPPLIC
ADD	EYUDA	CPSM	4	Yes	LIKE	No	Add option	NO			8
ADD Input/output valid values	YES, NO
BACKUPTYPE	CVDAS	CPSM	4	Yes	LIKE	No	CICS VSAM file backup type	STATIC			13
BACKUPTYPE Input/output valid values	STATIC, DYNAMIC
BASENAME	CHAR	CPSM	8	No	DIFF	No	Base data set name			E330+	43
BROWSE	EYUDA	CPSM	4	Yes	LIKE	No	Browse option	NO			9
BROWSE Input/output valid values	YES, NO
CATNAME	CHAR	CPSM	7	No	DIFF	No	VSAM catalog name			EALL	70
CHANGEAGENT	CVDAS	CPSM	4	No	LIKE	No	Last modification agent			E640 E650	74
CHANGEAGENT Input/output valid values	DREPAPI
CHANGEAGREL	CHAR	CPSM	4	No	DIFF	No	Last modification agent release			E640 E650	76
CHANGETIME	DATETIME	CPSM	8	Yes	MAX	No	Last modification				1
CHANGEUSRID	CHAR	CPSM	8	No	DIFF	No	Last modification user ID			E640 E650	75
CNTLINTRVAL	CHAR	CPSM	4	No	DIFF	No	Control interval size		512-4096	EALL	45
CREATETIME	DATETIME	CPSM	8	Yes	MAX	No	Time created				52
CSDGROUP-3	CHAR	CPSM	8	Yes	DIFF	Yes	CSD group			E640 E650	78
DATABUFFERS	CHAR	CPSM	8	No	DIFF	No	Number of data buffers	2	2-32767		14
DEFVER-2	BINARY	CPSM	1	Yes	AVG	Yes	Version	0	0-15		5
DELETE	EYUDA	CPSM	4	Yes	LIKE	No	Delete option	NO			10
DELETE Input/output valid values	YES, NO
DESCCODEPAGE	BINARY	CPSM	4	No	DIFF	No	Description code page	37	0-99999999		73
DESCRIPTION	CHAR	CPSM	58	No	DIFF	No	Description				56
DISPOSITION	CVDAS	CPSM	4	Yes	LIKE	No	Disposition of file	SHARE			15
DISPOSITION Input/output valid values	SHARE, OLD
DSNAME	CHAR	CPSM	60	No	DIFF	No	Data set name				51
DSNSHARING	EYUDA	CPSM	4	Yes	LIKE	No	VSAM data set name sharing	ALLREQS			16
DSNSHARING Input/output valid values	ALLREQS, MODIFYREQS
EXTFILEMGR	CHAR	CPSM	4	No	DIFF	No	Use external file manager	N		EALL	63
EXTFILEMGR Input/output valid values	N, Y
FILEACCESS	CHAR	CPSM	1	No	DIFF	No	Access method	R		EALL	60
FILEACCESS Input/output valid values	O, R, U
FILENABLED	CHAR	CPSM	1	No	DIFF	No	File enabled status	Y		EALL	58
FILENABLED Input/output valid values	N, Y, U
FILEOPEN	CHAR	CPSM	1	No	DIFF	No	File open status	Y		EALL	57
FILEOPEN Input/output valid values	N, Y
FILETYPE	CHAR	CPSM	1	No	DIFF	No	Data set type	K		EALL	59
FILETYPE Input/output valid values	A, E, K, R
FSEGDEFNAME	CHAR	CPSM	8	No	DIFF	No	File segment definition name			EALL	64
FSEGDEFVER	CHAR	CPSM	2	No	DIFF	No	File segment definition version		1-15	EALL	65
FWDRECOVLOG	CHAR	CPSM	4	No	DIFF	No	Journal number used for forward recovery	NO	1-99		17
FWDRECOVLOG Input/output valid values	NO
INDEXBUFFERS	CHAR	CPSM	8	No	DIFF	No	Number of index buffers	1	1-32767		18
JNLADD	EYUDA	CPSM	4	Yes	LIKE	No	Add operations recorded on journal	NONE			19
JNLADD Input/output valid values	NONE, AFTER, ALL, BEFORE
JNLREAD	EYUDA	CPSM	4	Yes	LIKE	No	Read operations recorded on journal	NONE			20
JNLREAD Input/output valid values	NONE, ALL, READONLY, UPDATEONLY
JNLSYNCREAD	EYUDA	CPSM	4	Yes	LIKE	No	Synchronous auto journaling for input	NO			21
JNLSYNCREAD Input/output valid values	YES, NO
JNLSYNCWRITE	EYUDA	CPSM	4	Yes	LIKE	No	Synchronous auto journaling for output	YES			22
JNLSYNCWRITE Input/output valid values	YES, NO
JNLUPDATE	EYUDA	CPSM	4	Yes	LIKE	No	Rewrite/delete operations recorded on journal	NO			23
JNLUPDATE Input/output valid values	YES, NO
JOURNAL	CHAR	CPSM	4	No	DIFF	No	Journal number	NO	1-99		25
JOURNAL Input/output valid values	NO
KEYLENGTH	CHAR	CPSM	4	No	DIFF	No	Key length		1-255		26
KEYNUMBER	CHAR	CPSM	2	No	DIFF	No	Key number		1-99	EALL	62
LOADTYPE	EYUDA	CPSM	4	No	LIKE	No	Load type	NO			69
LOADTYPE Input/output valid values	YES, NO
LOG	EYUDA	CPSM	4	Yes	LIKE	No	Automatic logging	NO		E330+	50
LOG Input/output valid values	YES, NO
LSRPOOLID	CHAR	CPSM	4	No	DIFF	No	LSR Pool number	1	1-255		27
LSRPOOLID Input/output valid values	NONE
MAXNUMRECS	CHAR	CPSM	8	No	DIFF	No	Maximum number of records in data table	NOLIMIT	1-99999999		28
MAXNUMRECS Input/output valid values	NOLIMIT
MAXRECORDLEN	CHAR	CPSM	6	No	DIFF	No	Maximum record length		1-32767	EALL	61
MINRECORDLEN	CHAR	CPSM	4	No	DIFF	No	Minimum record length		1-4090	EALL	44
NAME-1	CHAR	CPSM	8	Yes	DIFF	Yes	Name				7
NSRGROUP	CHAR	CPSM	8	No	DIFF	No	Non-shared resources (NSR) group name				29
OPENTIME	EYUDA	CPSM	4	Yes	LIKE	No	File open time	FIRSTREF			30
OPENTIME Input/output valid values	FIRSTREF, STARTUP
PASSWORD	HIDCHAR	CPSM	8	No	DIFF	No	User access password				31
POOLNAME	CHAR	CPSM	8	No	DIFF	No	Coupling facility data table (CFDT) pool name				66
READ	EYUDA	CPSM	4	Yes	LIKE	No	Read option	YES			11
READ Input/output valid values	YES, NO
READINTEG	CVDAS	CPSM	4	Yes	LIKE	No	Default level of read integrity	UNCOMMITTED			32
READINTEG Input/output valid values	UNCOMMITTED, CONSISTENT, REPEATABLE
RECORDFORMAT	CVDAS	CPSM	4	Yes	LIKE	No	Record format	VARIABLE			33
RECORDFORMAT Input/output valid values	VARIABLE, FIXED
RECORDSIZE	CHAR	CPSM	8	No	DIFF	No	Record size		1-32767		34
RECOVERY	EYUDA	CPSM	4	Yes	LIKE	No	Type of recovery	NONE			35
RECOVERY Input/output valid values	NONE, ALL, BACKOUTONLY
REMOTENAME	CHAR	CPSM	8	No	DIFF	No	Remote file name				36
REMOTESYSTEM	CHAR	CPSM	4	No	DIFF	No	Remote system name				37
RLSACCESS	EYUDA	CPSM	4	Yes	LIKE	No	Record level sharing (RLS) file access mode	NO			38
RLSACCESS Input/output valid values	YES, NO
RSL	CHAR	CPSM	8	No	DIFF	No	Resource security value	0	0-24	E330+	46
RSL Input/output valid values	PUBLIC
SHR4ACCESS	EYUDA	CPSM	4	No	LIKE	No	VSAM share access	KEY		EALL	72
SHR4ACCESS Input/output valid values	KEY, RBA
STATUS	CVDAS	CPSM	4	Yes	LIKE	No	Initial status	ENABLED			39
STATUS Input/output valid values	ENABLED, DISABLED, UNENABLED
STRINGS	CHAR	CPSM	4	No	DIFF	No	Maximum concurrent requests against file	1	1-255		40
TABLE	EYUDA	CPSM	4	Yes	LIKE	No	Data table type	NO			41
TABLE Input/output valid values	NO, CICS, USER, CF
TABLENAME	CHAR	CPSM	8	No	DIFF	No	Table name				67
UPDATE	EYUDA	CPSM	4	Yes	LIKE	No	Update option	NO			12
UPDATE Input/output valid values	YES, NO
UPDATEMODEL	CVDAS	CPSM	4	No	LIKE	No	Update model	LOCKING			68
UPDATEMODEL Input/output valid values	LOCKING, CONTENTION
USERDATA1	CHAR	CPSM	8	No	DIFF	No	User data area 1				53
USERDATA2	CHAR	CPSM	8	No	DIFF	No	User data area 2				54
USERDATA3	CHAR	CPSM	8	No	DIFF	No	User data area 3				55

FILEDEFtab.html | Timestamp icon

Last updated: Thursday, 27 June 2019