DSNAME Resource Table

A CICS® Resource that describes a data set in use by an active CICS system being managed by CICSPlex® SM.

The Primary key field for this resource class is  DSNAME .

The following actions are supported:

BACKOUT
Back out shunted in-doubt units of work associated with the data set.
COMMIT
Commit shunted in-doubt units of work associated with the data set.
FORCE
Force shunted in-doubt units of work associated with the data set to commit or back out.
IMMQUIESCE
Immediately quiesce the data set; all units of work are abended.
QUIESCE
Quiesce the data set; all units of work are allowed to reach syncpoint.
REMOVE
Remove the data set.
UNQUIESCE
Unquiesce the data set.

The parameter data for the IMMQUIESCE, QUIESCE, and UNQUIESCE actions is:

   PARM('BUSY(cvda).')

where cvda is required and is one of the following valid CVDA values for the data set busy condition:

Note:
From CICS Transaction Server for OS/320 Version 2 Release 1, the action names IMMQUIESE, QUIESE, and UNQUIESE are amended to IMMQUIESCE, QUIESCE, and UNQUIESCE. The previous versions of the action names still work, but the new action names are preferred.
Length
176
Usage
API
API view
Yes
CMAS context
No
SCOPE applies
Yes
Only query CMASs in workload
No
Object type
CICS Resource
Copybook identifier
EYUt0011 or DSNAME
Valid API operations
GET SET and PERFORM

API Actions

REMOVE
Remove

Parameters: None

IMMQUIESE
Immediate quiesce (deprecated)

PARM(' BUSY(value) .')

QUIESE
Quiesce (deprecated)

PARM(' BUSY(value) .')

UNQUIESE
Unquiesce (deprecated)

PARM(' BUSY(value) .')

IMMQUIESCE
Immediate quiesce

PARM(' BUSY(value) .')

QUIESCE
Quiesce

PARM(' BUSY(value) .')

UNQUIESCE
Unquiesce

PARM(' BUSY(value) .')

BACKOUT
Back out

Parameters: None

COMMIT
Commit

Parameters: None

FORCE
Force

Parameters: None

Table 118. DSNAME resource table attributes
Name Datatype Source Len Sum Set Description Get Invalid Attr ID
EYU_CICSNAME CHAR CPSM 8 N/A CICS System Name
EYU_CICSREL CHAR CPSM 4 N/A CICS Release
EYU_RESERVED CHAR CPSM 4 N/A Reserved
 DSNAME-1  CHAR INQ 44 DIF Data set name 1
ACCESSMETHOD CVDAS INQ 4 LIKE Access method 2
ACCESSMETHOD Output Valid Values VSAM BDAM
BACKUPTYPE CVDAS INQ 4 LIKE Type of backup 3
BACKUPTYPE Output Valid Values STATIC DYNAMIC UNDETERMINED NOTAPPLIC
BASEDSNAME CHAR INQ 44 DIF Base data set name 4
BKOUTSTATUS CVDAS INQ 4 LIKE yes Backout status 5
BKOUTSTATUS Input/Output Valid Values NORMALBKOUT FAILEDBKOUT
BKOUTSTATUS Output Valid Values FAILINGBKOUT NOTAPPLIC
FILECOUNT BINARY INQ 4 AVG Number of file definitions that reference data set 6
OBJECT CVDAS INQ 4 LIKE Data set type 7
OBJECT Output Valid Values BASE PATH
RECOVSTATUS CVDAS INQ 4 LIKE Recovery status 8
RECOVSTATUS Output Valid Values RECOVERABLE FWDRECOVABLE NOTRECOVABLE UNDETERMINED NOTAPPLIC
VALIDITY CVDAS INQ 4 LIKE Data set validity status 9
VALIDITY Output Valid Values VALID INVALID
FWDRECOVLOG CODEDBIN INQ 2 AVG Journal number 10
FWDRECOVLSN CHAR INQ 26 DIF Forward recovery log stream name 11
AVAILABILITY CVDAS INQ 4 LIKE yes Availability status 12
AVAILABILITY Input/Output Valid Values AVAILABLE UNAVAILABLE
AVAILABILITY Output Valid Values NOTAPPLIC
LOSTLOCKS CVDAS INQ 4 LIKE Lost locks status 13
LOSTLOCKS Output Valid Values NOLOSTLOCKS REMLOSTLOCKS RECOVERLOCKS NOTAPPLIC
QUIESCESTATE CVDAS INQ 4 LIKE yes Record level sharing (RLS) quiesce state 14
QUIESCESTATE Input/Output Valid Values UNQUIESCED QUIESCED
QUIESCESTATE Output Valid Values QUIESCING NOTAPPLIC
RETLOCKS CVDAS INQ 4 LIKE Retained record locks status 15
RETLOCKS Output Valid Values RETAINED NORETAINED
[[ Contents Previous Page | Next Page Index ]]