Usage considerations
This section discusses special considerations for using the CWDDALLU utility.
Renaming Shared Directories and Databases
To rename a database, you must first detach it from its shared directory and then rename it. You must then re-attach it to the shared directory in order to retain the correct references. The newly renamed databases must be attached to the shared directory before it can be used.
To rename a shared directory, you must first detach all its databases from the old shared directory. Then, re-attach all of the databases to the renamed shared directory.
Dynamic Creation of Source Listing Databases
This new feature allows dynamic creation of a new Source Listing Database, during creation of a new source listing member, if all attached files in the shared directory are not selectable (full, or not enough space for that member) and you specified CWPDDIO as a shared directory. You must also have previously set up a valid DBMODEL with DYNCREATE=YES in that shared directory using CREATE. The dynamic create function is NOT invoked during the CWDDLPUT utility functions ATTACH or CONVERT. It is not applicable to report files, report databases or report shared directories.
DD Statements Used with CWDDALLU
The following is a description of each DD statement required for CWDDALLU. DD Statements Used with CWDDALLU Batch Commands list the required and optional DD statements used with CWDDALLU batch commands.
ABNLPARM
The ABNLPARM DD statement specifies the control data set. Normally, the control data set resides in the input stream; however, it can reside on a system input device or it can be defined as a member in a partitioned data set. You must specify the ABNLPARM DD statement each time you run the batch file utility. The ddname ABNLPARM cannot be altered.
ABNLREPT
The ABNLREPT DD statement specifies a sequential data set for messages and reports produced by CWDDALLU. You must specify the ABNLREPT DD statement each time you run the batch file utility. The ddname ABNLREPT cannot be altered. The recommended record length for a ABNLREPT data set is 133
ABNLRPT2
The ABNLRPT2 DD statement specifies an optional DUMMY data set to suppress the Copy right information displayed in the ABNLREPT DD statement only for the TYPE=AA commands like DIR, DIRX produced by CWDDALLU.
The above statement when included in the JCL suppresses the copyright information generated by the commands in the ABNLREPT DD statement and does not impact the remaining output produced by that command.
ABNLFROM
The ABNLFROM DD statement specifies the default input file for the COPY, EXPORT, IMPORT, and MOVE commands. This default can be overridden using the FROMDD or FROMDSN parameter.
ABNLTO
The ABNLTO DD statement specifies the default output file for the COPY, EXPORT, IMPORT, and MOVE commands. This default can be overridden using the TODD or TODSN parameter.
ABNLDFIL
The ABNLDFIL DD statement, if supplied, specifies the default primary input file for most CWDDALLU commands. This default can be overridden using the DDNAME or DSN parameter.
Anyname1
The Anyname1 DD statement specifies an optional sequential data set for a printed member for the PRINT command. The actual ddname is defined by the OUTDD parameter of the PRINT command. If this parameter is not defined, the member will be written to the file specified by the ABNLREPT DD statement.
The data set specified by the anyname1 DD statement must use RECFM=FBM and LRECL=133. The BLKSIZE must be a multiple of the LRECL value. If the data set is a new data set (DISP=NEW) and the DCB parameters are not specified, the default BLKSIZE value is 133.
DD Statements Used with CWDDALLU Batch Commands
ABNLPARM | ABNLREPT | ABNLRPT2 | ABNLDFIL | ABNLFROM | ABNLTO | anyname1 | |
---|---|---|---|---|---|---|---|
ATTACH | X | X | O | ||||
CHANGE | X | X | O | ||||
CONVERT | X | X | O | ||||
COPY | X | X | O | O | |||
CREATE | X | X | |||||
DELETE | X | X | O | ||||
DETACH | X | X | O | ||||
DIR | X | X | O | O | |||
DIRI | X | X | O | O | |||
DIRS | X | X | O | O | |||
DIRX | X | X | O | O | |||
ESTIMATE | X | X | |||||
EXAMINE | X | X | O | ||||
EXPAND | X | X | O | ||||
EXPORT | X | X | O | O | |||
FLAG | X | X | |||||
FORMAT | X | X | O | ||||
IMPORT | X | X | O | O | |||
LOCK | X | X | |||||
MOVE | X | X | O | O | |||
X | X | O | |||||
REFRESH | X | X | O | ||||
RESET | X | X | O | ||||
SCRATCH | X | X | |||||
TEST | X | X | O | ||||
UNCONVERT | X | X | O | ||||
UNLOCK | X | X | O | ||||
VERIFY | X | X | O | ||||
X — Required; O — Optional |