Control statements for the Unload task

The control statement block for the Unload task contains the user specifications for controlling the unload process.

You can code the following statements in the (UNLOAD) block of the HPSIN control statements:

  • Control statements for Unload function
  • Control statements for HSSR Engine

In parallel reorganization, DD name SYSUT2 specified in an OUTPUT control statement has a special meaning; data written to SYSUT2 DD by Unload task is redirected to the input (identified by DFSUINPT DD) for the Reload task.

The PARTITION control statement cannot be specified in the (UNLOAD) block. When you select HALDB partitions to reorganize, the PARTITION control statement must be specified in the (REORG) block .

The following table shows the control statements that are used to control the unload function.

Table 1. Control statements used for controlling Unload function
Keyword Acceptable values Default Description
DECOMPRESS YES or NO NO Specifies whether to decompress compressed segments. See DECOMPRESS control statement.
OUTPUT (See OUTPUT control statement.) SYSUT2,*HD Specifies the characteristics of the output data sets to be created and the optional user exit routine for the output.

The default DD name SYSUT2 has a special meaning; the data written into SYSUT2 is passed to the Reload task. For DD name SYSUT2, only the *HD unload record format is allowed.

If UNLOADONLY=YES is specified in the (REORG) block, the default DD name is DFSURGU1. SYSUTn (n=2,3,4) is not supported.

If CRUNLOAD=COND or CRUNLOAD=ALWAYS is specified in the (REORG) block, the default DD name is DFSURGU1. SYSUTn (n=3,4) is not supported.

See OUTPUT control statement.

PROGMON 0 - 999999 0 Specifies whether to monitor the progress of the Unload task. See PROGMON control statement.
RAPCHECK YES or NO NO Specifies to check whether each root segment of HDAM/PHDAM database is chained off from the correct RAP. See RAPCHECK control statement.
SEGSEL (segma,…,segmz) or *ALL *ALL Specifies the names of the segments to be unloaded selectively. See SEGSEL control statement.

The following table shows the control statements that are applied to the additional unload data sets when SYSUT3 or SYSUT4 is specified for the OUTPUT control statement.

Table 2. Control statements used for additional unload data sets
Keyword Acceptable values Default Description
CHECKREC YES or NO NO Specifies whether the check record used by the IPR Reload utility is added to the unload data set. See CHECKREC control statement.
USERHDR (elem1,…,elemN)   Specifies the list of the elements in the header portion of the *UH unload format record. For example: 
OUTPUT=SYSUT3,*UH
USERHDR=(HDRLEN,SEGNAME,
ROOTKEY)
See USERHDR control statement.

The control statements for HSSR Engine can be specified for the Unload task. The statements listed in the following table are allowed.

The following table shows control statements used to control HSSR Engine.

Table 3. Control statements used for controlling HSSR Engine
Keyword Acceptable values Default Description
BLDLPCK YES or NO NO Specifies whether to retrieve logical parent's concatenated keys (LPCKs). See BLDLPCK control statement.
BUFFERS (See BUFFERS control statement.) *ALL,,8,,100, YES,YES Change the buffering options for tuning. See BUFFERS control statement.
BUFSTAT YES or NO NO Specifies whether to produce buffering statistics. See BUFSTAT control statement.
BYINDEX YES or NO NO Specifies whether to retrieve HIDAM root segments through the HIDAM index. See BYINDEX control statement.
CABBASE (See CABBASE control statement.) (No default) Specifies the basic buffer size for CAB. See CABBASE control statement.
COMPAUTH YES or NO NO Specifies whether to call the segment compression exit in supervisor state. See COMPAUTH control statement.
DBSTATS (See DBSTATS control statement.) NO Specifies whether to produce database statistics. See DBSTATS control statement.
DIAGG (See DIAGG control statement.) NO Specifies whether to generate diagnosis information for status code GG. See DIAGG control statement.
KEYCHECK NO
ABEND
GG
GX		 NO Specifies whether to check the sequence of sequenced keys. See KEYCHECK control statement.
PARTSTAT YES or NO NO Specifies whether to print statistics report for each HALDB partition. See PARTSTAT control statement.
SKIPERROR 0 - 999999999 0 Specifies the number of errors to skip. See SKIPERROR control statement.
TRACE (See TRACE control statement.) (No default) Specifies whether to generate the trace report. See TRACE control statement.
RTEXIT exitname HPSURTEX Specifies the name of the runtime exit routine. See RTEXIT control statement.

For the description of each statement, see Control statements for HSSR Engine.