The DSNAME view shows general information about data sets associated with installed CICS files.
The DSNAME view is available all managed CICS systems.
dataset
is
the specific or generic name of a data set that is associated with installed
CICS files. If you omit this parameter, the view includes information about
all data sets within the current scope.
Figure 62 is an example of the DSNAME view.
27FEB2005 18:26:11 ----------- INFORMATION DISPLAY --------------------------- COMMAND ===> SCROLL ===> PAGE CURR WIN ===> 1 ALT WIN ===> W1 =DSNAME============EYUPLX01=EYUPLX01=27FEB2005==18:26:11====CPSM===========4 CMD Dataset CICS File Backout --- Name------------------------------------ System-- Count--- Status----- PAYROLL.SALARY.ADMIN.SYSTEMA.DFHCSD EYUMAS1A 1 NORMALBKOUT PAYROLL.SALARY.ADMIN.SYSTEMA.DFHCSD EYUMAS2A 1 NORMALBKOUT PAYROLL.SALARY.ADMIN.SYSTEMA.DFHCSD EYUMAS3A 1 NORMALBKOUT PAYROLL.SALARY.ADMIN.SYSTEMA.DFHCSD EYUMAS4A 1 NORMALBKOUT
Table 127 shows the action commands you can issue from the DSNAME view. The overtype field is shown in Table 128.
The action commands and overtype field for the DSNAME view are available for all managed CICS® systems for which DSNAME is valid, except as noted in Table 127 and Table 128.
Primary command | Line command | Description |
---|---|---|
QUIesce
dataset sysname |
QUI | Displays the Quiesce State for Dataset input panel (Figure 63), which lets you specify whether the data set is to be immediately quiesced, quiesced when all units of work that are accessing the data set have reached syncpoint, or unquiesced. |
REMove
dataset sysname |
REM | Removes the association between a data set and a CICS system and deallocates the data set. A data set can be removed only if its file count is 0 and its backout status is NORMALBKOUT. |
ReSetLocks
dataset sysname |
RSL | (VSAM only.) Purges shunted unit of work log records
for backout-failed and commit-failed units of work that hold locks on the data set,
and releases the retained locks. All records relating to this data set are
removed from the system log and all retained record locks held for the data
set are released.
Notes:
|
n/a | SET | Sets a data set attribute according to the
new value you specify in an overtype field (see Table 128).
Note:
The value you specified in the Require Set field on the CICSPlex® System Manager entry
panel determines whether or not you must use the SET command when you overtype
a field. |
UOW
dataset sysname |
UOW | Displays the Shunted UOWs Holding Locks on Dataset input panel (Figure 64), which lets you specify whether a shunted in-doubt unit of work that holds a lock on this data set should be backed out, committed, forced, or retried. |
Where:
|
When you issue the QUIesce action command from the DSNAME view, the Quiesce State for Dataset input panel appears, as shown in Figure 63.
--------------------- Quiesce State for Dataset ------------------------------- COMMAND ===> Dataset Name PAYROLL.SALARY.ADMIN.SYSTEMA.DFHCSD Current Scope ==> EYUCMS1A Quiesce State ==> (QUIESCED, IMMQUIESCED, UNQUIESCED) Press Enter to process quiesce state. Type END or CANCEL to cancel quiesce state.
Specify the RLS quiesce state of the data set:
When you issue the UOW action command from the DSNAME view, the Shunted UOWs Holding Locks on Dataset input panel appears, as shown in Figure 64.
--------------------- Shunted UOWs Holding Locks on Dataset ------------------- COMMAND ===> Dataset Name PAYROLL.SALARY.ADMIN.SYSTEMA.DFHCSD Current Scope EYUCMS1A Action ==> (BACKOUT, COMMIT, FORCE, RETRY) Press Enter to process action. Type END or CANCEL to cancel action.
Specify the action to be taken for a shunted in-doubt unit of work that holds a lock on this data set:
Field name | Values |
---|---|
Backout Status | NORMALBKOUT | FAILEDBKOUT (VSAM only)
Cannot be modified in systems running the CICS TS for OS/390. |
Table 129 shows the hyperlink fields on the DSNAME view.
Hyperlink field | View displayed | Description |
---|---|---|
Dataset Name | DSNAMED | Detailed view of the specified data set. |
File Count | FILED | Detailed view of information about CICS files associated with the data set. |