Control statements for the DFSURUL0 utility

The DFSURUL0 utility has two control statements to define its processing options: CHANGE and OPTIONS.

Position

Description

1

Must contain either an 'R' or an 'X'.

R: Indicates a HISAM Reorganization Unload utility control statement
X: Indicates a secondary index reorganization control statement

There is no default; if this position is left blank, an error message is generated.

2

Must contain a 1 or a 2, depending on the number of output copies required. There is no default; if this position is left blank, an error message is generated.

3

Must contain a 'M', 'E', 'R', or a blank for secondary index reorganization ('X' in position 1) control statements. If the value of this position is blank, the default is M.

M: Indicates that the index work data set created during either a database initial load or reorganization (using the Prefix Resolution utility) is to be merged into an existing secondary index or used to create a secondary index if the data set does not exist.
E: Indicates that the secondary index (defined by the constant in position 49 of this statement) is to be extracted from either a shared index database or from the index work data set (from the Prefix Resolution utility).
R: Indicates that those segments in the secondary index that match the constant in position 49 of this statement are to be replaced with matching segments found in the work data set. If the secondary index segments being replaced need to be saved, perform an extract function prior to the replace.

4-12

Must contain the name of the DBD that includes the ddnames of the VSAM data set group that is to be reorganized.

13-21

Must contain the KSDS ddname for the VSAM data set that is to be reorganized. The ddname is the primary data set name for the HISAM database and the secondary index ddname for the secondary index database. It must appear in the referenced DBD statement, and a corresponding DD statement must be provided.

22-30

Must contain the ddname of the primary output data set. A corresponding DD statement must be provided.

31-39

Must contain the ddname of the second copy of the reorganized output data set. If this field contains the ddname, a corresponding DD statement must be provided. This field must be blank if position 2 contains a 1.

40-48

Must contain the ddname of the secondary index work data set if this control statement is type 'X'.

49

Must contain the 1-byte constant specified in the DBD generation of the shared secondary index if 'E' or 'R' is specified in position 3 of this statement.

50-80

Can contain comments or specify control interval (CI) or record size changes. To specify the source of CI or record size changes, code CHNG=DBD or CHNG=CARD, where DBD tells the unload utility to use the DBD values for KSDS and ESDS CI and record sizes, and CARD tells the unload utility to use the values specified on the control statement that starts with CHANGE in column 1.

CHANGE statement


             .-,----------------.      
             V                  |      
>>-CHANGE=(----+-KSCISZ=nnnnn-+-+--)---------------------------><
               +-ESCISZ=nnnnn-+        
               +-KSREC=nnnnn--+        
               '-ESREC=nnnnn--'

This is an optional control statement. If you use this statement, you must specify at least one keyword.

CHANGE=

Identifies the CHANGE control statement.

KSCISZ: Specifies a new KSDS CI size in bytes. The size is specified in multiples of 512 bytes.
ESCISZ: Specifies a new ESDS CI size in bytes. The size is specified in multiples of 512 bytes.
KSREC: Specifies a new KSDS record size.
ESREC: Specifies a new ESDS record size.

nnnnn

Is a five-digit decimal value, including leading zeros if necessary. The maximum value is 32767.

Example: The CHANGE statement is used to specify a new KSDS CI size and a new ESDS CI size in this example:

CHANGE=(KSCISZ=01024,ESCISZ=02048)

OPTIONS statement


              .-,------------.      
              V .-STATS----. |      
>>-OPTIONS=(----+-ABEND----+-+--)------------------------------><
                +-ABENDOFF-+        
                '-NSTAT----'

This is an optional control statement.

OPTIONS=

Identifies the OPTIONS control statement.

STATS: Provides statistics to the SYSPRINT data set and to the HISAM Reorganization Reload utility. STATS is the default.
ABEND: Turns on the ABEND function. If any condition arises causing termination of the run, terminates the run with abend U0359. A dump is printed if a SYSABEND or SYSUDUMP DD statement is supplied.
ABENDOFF: Turns off the ABEND function.
Exception: ABENDOFF is the initial default; however, if ABEND has been specified previously, it remains in effect until ABENDOFF is coded.
NSTAT: Specifies that no statistics output be generated. If this parameter is used, the HISAM Reorganization Reload utility also ignores statistics output.