DSNAME - Data sets

The DSNAME view shows general information about data sets associated with installed CICS files.

Note:
Full data set information is not available until at least one file that references the data set is opened.

Availability

The DSNAME view is available all managed CICS systems.

Access

Issue command:
DSNAME [dataset]

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.

Select:
FILE from the OPERATE menu, and DSNAME from the FILE submenu.

Figure 62 is an example of the DSNAME view.

Figure 62. 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
 
 

Action commands

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.

Table 127. DSNAME view action commands
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:
  1. This command cannot be used for shunted in-doubt units of work that hold locks on the data set. Before you issue the ReSetLocks command, use the UOW action command to resolve the in-doubt unit of work.
  2. When a ReSetLocks action fails during the commit phase, the units of work revert to being shunted as commit-failed.
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:
dataset
Is the specific or generic name of a data set.
sysname
Is the specific or generic name of a CICS system.

When you issue the QUIesce action command from the DSNAME view, the Quiesce State for Dataset input panel appears, as shown in Figure 63.

Figure 63. The Quiesce State for Dataset input panel
 --------------------- 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:

IMMQUIESCED
All existing CICS open RLS ACBs are closed, all units of work accessing the data set are abended, the file state (if it is ENABLED) is set to UNENABLED, and the data set is marked as closed.
Note:
Any tasks currently using the data set are immediately terminated, using the CICS task FORCEPURGE.
QUIESCED
All existing CICS open RLS ACBs are closed, all units of work accessing the data set are allowed to reach syncpoint, the file state (if it is ENABLED) is set to UNENABLED, and the data set is marked as closed.
UNQUIESCED
The data set is marked as unquiesced, and RLS or non-RLS ACBs can be opened. Subsequent open ACB requests are permitted in the same mode as the first open ACB.
Note:
Only when you have UNENABLED a file by specifying either an IMMQUIESCED or a QUIESCED value, you can restore the file state to ENABLED by specifying UNQUIESCED.

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.

Figure 64. The Shunted UOWs Holding Locks on Dataset input panel
 --------------------- 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:

BACKOUT
Specifies that these units of work should be backed out.
COMMIT
Specifies that these units of work should be committed.
FORCE
Specifies that these units of work should be FORCED to BACKOUT or COMMIT.
RETRY
Specifies that these units of work should be retried. Applies only to backout-failed and commit-failed units of work.
Note:
If the data set was damaged, it must have been repaired (recreated) and made available for RETRY to be successful.

Table 128. DSNAME view overtype field
Field name Values
Backout Status NORMALBKOUT | FAILEDBKOUT (VSAM only)
Cannot be modified in systems running the CICS TS for OS/390.

Hyperlinks

Table 129 shows the hyperlink fields on the DSNAME view.

Table 129. DSNAME view hyperlink field
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.
Note:
You can also display the DSNAMES view by issuing the SUM display command.
[[ Contents Previous Page | Next Page Index ]]