Joined: 26 Nov 2002 Posts: 12359 Topics: 75 Location: San Jose
Posted: Thu Apr 29, 2004 9:37 am Post subject:
Misi,
Here is a tip that will help you. If you have quickref installed in your shop then just type QW sting-to-be-searched. In this case you want to say QW ADRDSSU and it will bring up the documentation. Now type QPRINT on the command prompt and the documentation is spooled to sdsf. Check your sysout and you will find the documentation.
[code:1:b666accbee]
The DFDSS Utility
Data Facility Data Set Services (DFDSS) is a program used to manage
DASD devices. DFDSS can be used to reduce DASD free space
fragmentation, copy or move data sets from one DASD device to
another, or dump and restore backup copies of entire DASD volumes.
The JCL required to execute DFDSS appears below. A description of
each JCL statement follows the sample JCL. A DFDSS control
statement syntax explanation appears below the JCL discussion. You
can type FIND '>DFDSS' on the command line above to skip to the
control statement descriptions.
Descriptions of each control statement parameter appear within the
MVS/QuickRef item name 'DFDSS2' or the alias item name 'ADRDSSU2'.
Examples of using DFDSS for different functions appear at the bottom
of this information entry.
DFDSS Sample JCL:
//JS10 EXEC PGM=ADRDSSU, DFDSS PROGRAM NAME
// PARM=parms... <== SEE PARM DESCRIPTIONS BELOW
//STEPCAT DD DSN=...,DISP=SHR OPTIONAL USER CATALOG
(CAN ALSO USE JOBCAT)
//SYSPRINT DD SYSOUT=* DFDSS MESSAGES WRITTEN HERE
//input DD DSN=...,DISP=SHR OPTIONAL INPUT DATA SET
//output DD DSN=...,DISP=SHR OPTIONAL OUTPUT DATA SET
//filter DD DSN=...,DISP=SHR OPTIONAL DATA SET SELECTION CARDS
//password DD DSN=...,DISP=SHR OPTIONAL DATA SET/PASSWORD CARDS
//SYSIN DD * SORT CONTROL CARD DATA SET
DFDSS control statements
/*
A description of each JCL statement above appears below:
EXEC Statement:
The EXEC statement invokes DFDSS and passes an optional PARM
field value. Possible PARM field values are:
ABEND=nnn - This parameter is used for debugging DFDSS problems.
It indicates the number of a DFDSS error message for which a U0001
abend is to forced when the ADRnnn message is issued. Include a
DD statement for SYSABEND, SYSMDUMP, or SYSUDUMP in order to get
a dump.
AMSGCNT=nnnn - This parameter tells DFDSS to end abnormally on
the occurrence indicated by nnnn of the message specified in the
ABEND= parm. nnnn defaults to 1 (i.e., first occurrence of the
indicated message) and can range in value from 1 to 9999.
LINECNT=nnnn - This parameter sets number of lines per printed
SYSPRINT data set page, given as 'nnnn'; 'nnnn' can be 1 thru
9999, the default is 60. You can eliminate automatic page ejection
completely by specifying LINECNT=9999.
PAGENO=nnnn - This parameter sets the beginning SYSPRINT data set
page number, given by 'nnnn'; 'nnnn' can be 1 thru 9999, the default
is 1.
SIZE=nnnnK - This parameter sets the DFDSS region size in K (1024
byte units). The default is the value set by the REGION= keyword
on the JCL EXEC statement, or the JOB statement.
TRACE=YES - This parameter is used for debugging the DFDSS DEFRAG
function. It indicates that trace messages are to be written to
SYSPRINT during a DEFRAG operation.
TMPMSGDS=YES | NO - This parameter indicates a temporary SYSPRINT
dataset is to be allocated when YES is coded. No is the default and
will improve performance by buffering messages in ESA Hiperspace.
TYPRUN=SCAN - This parameter requests that the control statements
passed to DFDSS be syntax checked, but no other processing is to be
done.
TYPRUN=NORUN - This parameter requests that only data set
filtering is to be done if a RESTORE, COMPRESS, COPY, DUMP, or
RELEASE operation is requested. If a DEFRAG is requested, then a
DEFRAG report is printed but no data sets are actually moved. A
full report is produced for a CONVERTV operation but no volumes
or data sets are actually converted. This parameter is useful for
simulating DFDSS processing to determine what its actual affect
will be.
UTILMSG=YES - This parameter requests that the messages issued by
any MVS utilities that DFDSS invokes are to appear on the SYSPRINT
data set if a COMPRESS or COPY function is requested.
RACFLOG=YES - This parameter requests RACF logging for all functions
if RACF 1.7 or higher is installed.
Note: This parm can set or overridden by the installation-
wide options exit.
WORKUNIT=wrkunt - This is an esoteric DASD unit name (like
SYSDA), a generic DASD unit name (like 3380), or a specific DASD
address that is to be used when temporary data sets are allocated
by DFDSS.
WORKVOL=volser - This is the volser on which DFDSS is to allocate
temporary data sets.
WORKUNIT and WORKVOL may be specified at the same time. The export
data set is allocated as a permanent data set which cannot be placed
on the volume specified by WORKUNIT and/or WORKVOL whenever DFDSS
uses IDCAMS to copy an ICF user catalog. Specifying an esoteric unit
name that requests virtual I/O causes IEHMOVE to be used and the
default dynamic allocation unit name to be (SYSALLDA).
XABUFF=ABOVE16 | BELOW16 - This parameter is used to request that
the buffers DFDSS uses during a DEFRAG, DUMP, RESTORE, COPY,
COPYDUMP, or PRINT function are to be allocated above the 16mb
address line (ABOVE16) or below the 16mb address line (BELOW16).
The default for MVS/XA is ABOVE16.
STEPCAT (or JOBCAT) DD:
Optional DD statement pointing to user catalog to be searched prior
to standard order of search. Required when:
-volume containing non-ICF VSAM data set cataloged in user
catalog is processed in full or track operation
-VSAM data sets in catalog outside the standard order of search
are logically dumped or copied
Must not be used when processing SMS-managed data sets.
SYSPRINT DD:
The messages DFDSS issues during processing are written to this
DD statement. It may go a DASD, tape, or SYSOUT. Do not specify a
block size or LRECL value in the SYSPRINT JCL.
Note: Use the WORKUNIT and/or WORKVOL parms to avoid S138
abends which result when a secondary allocation is needed
for a SYSPRINT file residing on a volume being processed
by DFDSS. (The abend is caused when the DADSM EXEND
function tries to enqueue on the VTOC which is already
enqueued by DFDSS.)
input DD:
Specifies an optional input file referred to by one or more
DFDSS control statement operands. 'input' is any unique DD name
you choose.
output DD:
Specifies an optional output file referred to by one or more
DFDSS control statement operands. 'output' is any unique DD name
you choose.
Note: If the output data set for a DUMP operation requires a
secondary allocation and resides on a DASD volume that
is being processed by DFDSS, a S138 abend may result
(since the DADSM EXEND function tries to enqueue on
a VTOC which is already enqueued by DFDSS.)
filter DD:
Specifies an optional sequential file containing data set
filtering control statements INCLUDE, BY, and EXCLUDE. 'filter'
is any unique DD name you choose.
Note: DD statements cannot be concatenated to the filter DD
statement.
password DD:
An optional sequential data set containing data set names and
their corresponding passwords for use when DFDSS is operating on
password protected data sets. 'password' is any unique DD name
you choose that will be referred to by one or more DFDSS control
statements.
SYSIN DD:
The control statements for DFDSS are input from this file. If must
be RECFM=FB, LRECL=80, with any blocksize that is a multiple of 80.
The DFDSS control statements are COMpress, CONVERTV, COPy, COPYDump,
DEFrag, DUMp, PRInt, RELease, RESTore, and the execution control commands
WTO, SERIAL, PARALLEL, SET, IF-THEN-ELSE, and EOJ.
Control statements are specified in columns 2 through 72 of the SYSIN
data set. The minimum specification for the command is the upper-case
portion of the command name or keyword name. Comments, preceded by '/*'
and followed by '*/' can appear anywhere but must start and end on the
same statement.
Control statement continuation is indicated by a blank followed by a
hyphen ('-') as the last character on a control statement. The continued
starts in any column 2 through 72 on the next statement.
You can continue a parameter by splitting it with plus sign ('+') and
finishing it on the next statement.
A brief explanation of and the syntax for each of the DFDSS control
statements is listed below. A complete description of each possible
keyword and parameter for the DFDSS control statements and their
acceptable abbreviations can be found under the MVS/QuickRef utility
item 'DFDSS2' or the alias item name 'ADRDSSU2'.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
BY:
The BY keyword allows data selection by specific criteria.
CREDT any Creation, Expiration, or Referenced date
EXPDT any in the form yyddd{,n} where:
REFDT any "yy" is year, "ddd" is day of year,
"n" is a + - relative digit. (*-1)
represents 1 day before the job run date.
EXTNT any # of extents or tracks used or allocated: nnnnn
FSIZE any 0 to 99999.
MULTI EQ Process multi- singlevolume data sets: YES | NO
DATACLAS EQ | NE SMS data class name:
MGMTCLAS EQ | NE SMS management class name:
STORCLAS EQ | NE SMS storage class name:
Valid operators for BY selector and argument parameters can be one
of the values between the { } symbols listed below:
{ EQ | = } for equal; if multiple argument, ANY true is selected
{ LE | <= } for less than or equal to
{ LT | < } for less than
{ GT | > } for greater than
{ GE | >= } greater than or equal to
{ NE | _________________ Kolusu - DFSORT Development Team (IBM)
DFSORT is on the Web at:
www.ibm.com/storage/dfsort
Joined: 26 Nov 2002 Posts: 12359 Topics: 75 Location: San Jose
Posted: Fri Apr 30, 2004 4:41 am Post subject:
Ravi,
You can execuete QW in batch also. Execueting in Batch gives you more control. It is too early in the morning and let me see if I can recollect the way to get the batch sample.
1.Type Qw at the command prompt and hit enter
2.You will get the main quickref screen
3. Press PF1(help)
4. If I remember correctly it will bring up help topics. In there some where you should find something like batch-execuetion or batch_execuetion.
5. place your cursor on the left side of that section and hit enter.
6. It will bring the help topic and I remember vaguely that it is quite descriptive.
Hope this helps...
Cheers
Kolusu _________________ Kolusu - DFSORT Development Team (IBM)
DFSORT is on the Web at:
www.ibm.com/storage/dfsort
You cannot post new topics in this forum You cannot reply to topics in this forum You cannot edit your posts in this forum You cannot delete your posts in this forum You cannot vote in polls in this forum
FAQ
Search
Quick Manuals
Register
Profile
Log in to check your private messages
Log in
