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 indoubt units of work associated with the data set.
COMMIT
Commit shunted indoubt units of work associated with the data set.
FORCE
Force shunted indoubt 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:
  • WAIT
  • NOWAIT
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.

External resource name
CICSDataSetName
Length
184
Usage
API or WUI or CICS Management Client Interface
API view
Yes
CMAS context
No
SCOPE applies
Yes
Only query CMASs in workload
No
Object type
CICS Resource
Copybook identifier
EYUt0011
Table 1. Valid CPSM operations
Operations Actions Parameters Required
GET   None N/A
SET   None N/A
REMOVE   None N/A
PERFORM SET IMMQUIESE BUSY(WAIT, NOWAIT) Yes
  QUIESE BUSY(WAIT, NOWAIT) Yes
  UNQUIESE BUSY(WAIT, NOWAIT) Yes
  IMMQUIESCE BUSY(WAIT, NOWAIT) Yes
  QUIESCE BUSY(WAIT, NOWAIT) Yes
  UNQUIESCE BUSY(WAIT, NOWAIT) Yes
  BACKOUT None N/A
  COMMIT None N/A
  FORCE None N/A
Table 2. DSNAME resource table attributes
Name Datatype Source Len Sum Set Description Get Invalid Attr ID
EYU_CICSNAME CHAR CPSM 8 DIF No CICS System Name    
EYU_CICSREL CHAR CPSM 4 DIF No CICS Release  
EYU_RESERVED CHAR CPSM 4 N/A No Reserved  
ACCESSMETHOD CVDAS INQ 4 LIKE No Access method   2
ACCESSMETHOD Input/output valid values VSAM, BDAM, NOTAPPLIC
AVAILABILITY CVDAS INQ 4 LIKE Yes Availability status   12
AVAILABILITY Input/output valid values AVAILABLE, UNAVAILABLE
AVAILABILITY Output valid values NOTAPPLIC
BACKUPTYPE CVDAS INQ 4 LIKE No Type of backup   3
BACKUPTYPE Output valid values STATIC, DYNAMIC, UNDETERMINED, NOTAPPLIC
BASEDSNAME CHAR INQ 44 DIFF No Base data set name   4
BKOUTSTATUS CVDAS INQ 4 LIKE Yes Backout status E510+ 5
BKOUTSTATUS Input/output valid values NORMALBKOUT, FAILEDBKOUT
BKOUTSTATUS Output valid values FAILINGBKOUT, NOTAPPLIC
 DSNAME-1  CHAR INQ 44 DIFF Yes Data set name   1
FILECOUNT BINARY INQ 4 AVG No Number of file definitions that reference data set   6
FWDRECOVLOG CNUMERIC INQ 2 AVG No Journal number   10
FWDRECOVLSN CHAR INQ 26 DIFF No Forward recovery log stream name   11
LOGREPSTATUS CVDAS INQ 4 LIKE Yes Replication Logging   16
LOGREPSTATUS Output valid values LOGREPLICATE, NOLOGREPLICA, NOTAPPLIC
LOSTLOCKS CVDAS INQ 4 LIKE No Lost locks status   13
LOSTLOCKS Output valid values NOLOSTLOCKS, REMLOSTLOCKS, RECOVERLOCKS, NOTAPPLIC
OBJECT CVDAS INQ 4 LIKE No Data set type   7
OBJECT Output valid values BASE, PATH, 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
RECOVSTATUS CVDAS INQ 4 LIKE No Recovery status   8
RECOVSTATUS Output valid values RECOVERABLE, FWDRECOVABLE, NOTRECOVABLE, UNDETERMINED, NOTAPPLIC
RETLOCKS CVDAS INQ 4 LIKE No Retained record locks status   15
RETLOCKS Output valid values RETAINED, NORETAINED, NOTAPPLIC
VALIDITY CVDAS INQ 4 LIKE No Data set validity status   9
VALIDITY Output valid values VALID, INVALID