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:
where cvda is required and is one of the following valid CVDA values for the data set busy condition:PARM('BUSY(cvda).')- WAIT
- NOWAIT
- 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
| 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 |
| Name | Datatype | Source | Len | Sum | Set | Description | Get Invalid | Attr ID |
|---|---|---|---|---|---|---|---|---|
| EYU_CICSNAME | CHAR | CPSM | 8 | DIFF | No | CICS System Name | ||
| EYU_CICSREL | CHAR | CPSM | 4 | DIFF | 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, RREPL | |||||||
| 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 | No | 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 | No | 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 | |||||||