Environment setup member options
The following table describes the options you can set for the environment setup member and the options you can override with the BMCSETUP DD statement.
The SETUP macro contains more options than are documented here; use the options not documented only at the request of BMC Customer Support.
Unless otherwise noted, these options do not have corresponding PLUSIN keywords.
Option | DLIGSET0 values | BMCSETUP DD values | Default | Description |
|---|---|---|---|---|
AGN | agnName | Not applicable | None | Specify an application group name for the BMP. |
AOI | Y N | Not applicable | N | Specify whether to use the Online Reorg function automated operator interface. |
AOIDISPC | 0-255 | AOIDISPC(n) | 30 (per try) | Specify the maximum number of times the Online Reorg function will check that a DBR or DBD command worked, before Online Reorg function resends or abandons the command. |
AOITRY | 0-99 | AOITRY(n) | 2 | Specify the maximum number of times Online Reorg function will attempt a DBR or DBD command. |
AOIUSER | progName | Not applicable | None | Specify whether to invoke a user exit routine before issuing a /DBR and after issuing a /STA. |
AOIWAIT | 0-99 | AOIWAIT(n) | 5 | Specify the number of seconds that Online Reorg function waits after DBR and DBD commands are sent to IMS and between checks to see if the command worked. |
AUTHREST | A N | AUTHREST(N) | N | Specify the HFR RESTART DBRC AUTH/NOAUTH option. The following options are available when run with SWAP(N):
|
AUTHTRY | n attempts | AUTHTRY(n) | 1 | AUTHTRY and AUTHWAIT specify what action the REORG utility should take if DBRC returns an error when attempting to get authorization on a database in the Post Processing phase. Specify the number of AUTH attempts to make before issuing a WTOR. |
AUTHWAIT | n seconds | AUTHWAIT(n5) | 5 | Specify the number of sends between each AUTH attempt. |
BMCPAU | 0 1 2 3 | BMCPAU(0) BMCPAU(1) BMCPAU(2) BMCPAU(3) | 0 | Specify whether to use the internal pause command in the CRF component:
|
BMCUNP | 0 1 | BMCUNP(0) BMCUNP(1) | 0 | Specify whether to use the internal unpause command In the CRF component:
|
BMPDISPC | 0-255 | BMPDISPC(n) | 30 (per try) | Specify the maximum number of times the Online Reorg function checks that all BMPs that were requested to stop were stopped. |
BMPTRY | 0-99 | BMPTRY(n) | 2 | Specify the maximum number of times Online Reorg function asks for BMPs to be stopped before attempting the DBR or before stopping with a WTOR CANCEL or RETRY. |
BMPWAIT | 0-99 | BMPWAIT(n) | 5 | Specify the number of seconds that Online Reorg function waits after requesting that a BMP be stopped and between checks to see if that BMP was stopped. |
BUFF64 | Y N | BUFF64(Y) BUFF64(N) | Y | Specify the memory type UNLOAD is to use:
|
CENTURY | Y N | CENTURY(Y) CENTURY(N) | Y | Turn the century indicator on or off:
|
CKUPDATE | (Y,STOP4094) (Y,OKAYnnnn) (N) | Not applicable | Y,STOP4094 | Specify whether to check the RECON data set for update allocation records dated after the unload file was created. If such records exist, specify the action to take. |
COPYIO | 0 1 | COPYIO(0) COPYIO(1) | 0 | Specify the behavior of the COPYIO engine. You can specify one of the following values:
|
COPYMIN | 1-65535 | COPYMIN(nnnnn) | 1000 | Specify the minimum size of the data set, in cylinders, used for a parallel copy. |
CREORG | Y N | CREORG(Y) CREORG(N) | Y | Specify the conditional reorg option:
|
CRFMSG | Y N | Not applicable | Y | Specify whether CRF should issue a message if CRF initialization fails in the control region.
|
CRFUNSP | 1-999 | CRFUNSP(1-999) | 100 | Specify the number of cylinders to be used for each extent of the temporary HD Unload file used in the Online Reorg function when no BMP is used. Because this might be a large amount of space, you can use this value to control SMS pool usage. |
CTLRGINI | Y,Y Y,N N,Y N,N | Not applicable | Y,Y | Controls the activation of CRF and BMC OLR in the control region. The first parameter specifies if CRF is activated and the second controls OLR.
|
DATACLAS | Not applicable | Any valid data class | None | Specify the SMS data class. |
DATE | (MDY,/) (DMY,/) (YMD,/) | Not applicable | MDY,/ | Specify the date format and separator. Any nonblank character can be the separator. (MDY,/) provides a date format of MM/DD/YY. |
DATEFORM | Not applicable | DATEFORM(MDY) DATEFORM(YMD) DATEFORM(DMY) | MDY | Specify the date format. |
DATESEP | Not applicable | DATESEP(value) | / | Specify the date separator. Any character is valid. |
DBR | F N | Not applicable | F | Specify whether to switch the OLDS during the /DBR at the end of the reorganization. |
DBRSCOPE | P M | Not applicable | P | Specify P to issue the /DBR command only for the HALDB partitions that you are reorganizing. Specify M to issue the /DBR command for the main HALDB (all partitions). Use this value to speed up post-processing when you are reorganizing the entire HALDB. |
DFSDBUX1 | Y N | Not applicable | Y | Specify if UNLOAD PLUS/EP for IMS or LOADPLUS/EP for IMS should invoke DFSDBUX1 when it is present in the STEPLIB or DFSRESLB:
|
DYNALLOC | (Y) (N) (Y,Y,Z) (N,Y) | Not applicable | N | Specify whether to dynamically allocate database data set, output (shadow) database data sets, and the data set name extension for dynamically allocated output data sets. |
EDMINIT | Y N | Not applicable | Y | Specify whether to activate EDM:
|
EOJACCES | EX UP RD RO | EOJACCESS(EX) EOJACCESS(UP) EOJACCESS(RD) EOJACCESS(RO) | Start the database in the same access it was in before the Reorg job. | Specify the access parameter that is appended to the final /STA command issued by a REORG job. |
EXSRTACT | Y N | Not applicable | Y | Specify if the ACCT= PARM is to be added to generated IEESYSAS JCL used for the external SECONDARY INDEX UTILITY sort address space. The account data from the batch job is copied to the ACCT= parameter.
|
EXTSORT | ALL SIU CRF HDSORT LOAD PRP COPY | EXTSORT(ALL) EXTSORT(SIU) EXTSORT(CRF) EXTSORT(HDSORT) EXTSORT(LOAD) EXTSORT(PRP) EXTSORT(COPY) | None | Specify which products should use the external sort facility. DLIGSET0 accepts multiple product names while BMCSETUP only allows one. |
FRFPRINT | Not applicable | Not applicable | BMCPRINT | See xxxPRINT. |
GSGNAME | gsgName | Not applicable | None | Specify a GSG name for RSR. |
HULABSP | 1-999 | Not applicable | 20 | Define the maximum amount of database buffer space to be used for the Unload function Application Program Interface (API). |
HULDBSP | 1-999 | Not applicable | 20 | Define the maximum amount of database buffer space to be used for the Unload function Database Selection Facility (DBSF) |
HULSBSP | 1-999 | Not applicable | 20 | Define the maximum amount of database buffer space to be used for DBSCAN. |
HULUBSP | 1-999 | Not applicable | 20 | Define the maximum amount of database buffer space for the Unload function to use. You can override the default you set here by specifying the BUFSPACE keyword. See BUFSPACE. |
ICP | Y N | Not applicable | N | Specify whether to invoke the Image Copy function. |
IDCAMS | (input) (input,output) (input,output, Y) (input,output, N) | Not applicable | ,,N | Specify input or input and output files for IDCAMS processing and whether to reclaim space after the Online Reorg. |
IMSID | imsID | Not applicable | None | Use imsid as the IMSID portion of the PDX key. |
IMSMACB | N Y | IMSMACB(N) IMSMACB(Y) | Y | N—This utility job step should not attempt to use IMS Managed ACBs regardless of the availability of contents of any DFS3CDX0 module, DFSDF parameter, or the IMS PARMLIB member. |
LANGUAGE | ENGLISH | Not applicable | ENGLISH | Do not change. |
LAPINOTR | F B N | Not applicable | F | Specify how to perform the NOTIFY.REORG LOAD API:
|
LDPPRINT | Not applicable | Not applicable | BMCPRINT | See xxxPRINT. |
LIMITDS | 1-2048 | Not applicable | None | Specify the load data space limit in megabytes (1 through 2048 MB). The load data space limit is the maximum space that will be used to create a single database record (for example, a root and all of its children). Sometimes this limit is implemented through MVS parameters. This limit does not include the data space that might be used to hold segments in memory due to the use of SEGPOS or SEQERROR. See SPILL. |
LIMITS | A P N | Not applicable | A | Specify whether to divide data into ranges when unloading it. |
LOGDSN (IEFRDER,CRFRDER) | &&DBD &&LOGDD &&DATE &&TIME | Not applicable | None | Specify a data set to record changed made to the database during the reorganization. |
LOGRETPD | 1-99999 | Not applicable | None | Specify how long to keep logs (in days). |
LOGSMS | (Y,mgmt,strg,data) | Not applicable | None | Use the specified SMS management class, storage class, and data class to allocate the log. |
LOGSPACE | (prim,sec) | Not applicable | 100,50 | Allocate the primary and secondary space for the logs in cylinders in the specified amounts. |
LOGUNIT | (unitName,unitName) | Not applicable | Values specified in installation parameters | Use the specified unit name to allocate the primary and secondary logs. |
MAXSORT | Not applicable | MAXTSORTI(n) MAXSORTO(n) | 3,0 | Specify the maximum sort tasks (internal and external) in the following format: MAXSORT (INT,EXT)
|
MINDB | Not applicable | Not applicable | 2000 | Specify the minimum size (in cylinders) of a database that will use parallel processing. |
MGMTCLAS | Not applicable | Any valid management class | None | Specify the SMS management class. |
MODLDSCB | Not applicable | Not applicable | SYS1.MODEL | Specify the standard model DSCB for GDGS. The model is used when CRGS logs are dynamically allocated GDGS. |
MONITOR | nnnnnnn | Not applicable | 0 | Monitor job progress at specified interval. |
MSGWTO | A C E I P R S W | Not applicable | None | Use this option to force all messages of the specified severities to be written to the operator console and the BMCMSG DD. The last character of the BMC message is the severity level of the message:
|
MVSCMND | Not applicable | Not applicable | Y | Specify whether to process MVS MODIFY and STOP commands:
|
NONRECOV | U N | NONRECOV(U) NONRECOV(N) | U | Specify whether the Extended Performance Utilities will complete DBRC notifications automatically when the database is registered as NONRECOV.
|
OSAMMAX | 4 8 | OSAMMAX(4) OSAMMAX(8) | 4 for IMS Version 5.1 8 for IMS Version 6.1 and later | Define the maximum OSAM database size. You can specify this option only if you are using IMS Version 5.1 or later. You can override the default you set here by specifying the OSAMMAX keyword in a PLUSIN control statement data set. See OSAMINIT. |
PARALLEL | Y N | Not applicable | Y | Specify whether to process files in parallel mode. |
PCP_FREQ | Y N | Not applicable | N | Specify whether POINTER CHECKER PLUS/EP frequency analysis is enabled. |
PCP_THRS | Not applicable | Not applicable | 0 | Specify the threshold percentage for the frequency report. |
PDXHP | Y N | Not applicable | N | Specify whether you want POINTER CHECKER PLUS to generate and update HP type PDX records. BMC recommends that you move away from using HP PDX records because of the high overhead involved in opening and closing the PDX and reading and writing the PDX directory for each type of PDX record. |
PERMUNIT | Any valid unit name | Any valid unit name | SYSALLDA | Assign a unit name for permanent data sets. |
Y N | PRINT(Y) PRINT(N) | N | Specify whether to list setup options in job output. | |
xxxPRINT with xxx as FRF, LDP, SIU, and ULP | ddname | Not applicable | BMCPRINT | Use the specified data set to contain reports and other output. |
RCFREQ | 1-255 | RCFREQ(n) | 0 (Do not release the DBRC ENQ.) | The DBU utilities can, in some instances, issue many calls to DBRC during which any other processes (such as IMS control regions) will not have access to the RECONs. For example, a HALDB with a high number of partitions requires many DBRC calls to retrieve partition information. This parameter instructs the utilities to periodically release the ENQ that controls access to the RECONs. Specify how many DBRC calls the utility should make before relinquishing control of the RECONs. |
RECONRDR | Y N | Not applicable | Y | Specify the RECON reader option:
|
RMBYTES | S M | Not applicable | M | Specify whether to use the segment’s VL SIZE field or its MINBYTES value to accumulate database record bytes. |
SMS | (N) (Y,mgmtclas,strgclas,dataclas) | SMS(Y) SMS(N) | N | Specify whether to supply SMS parameters for temporary data sets. In DLIGSET0, also specify management class, storage class, and data class. There is no corresponding PLUSIN keyword. However, if you specify SMS constructs here, you can override the sort-related SMS data sets with the SORTWORK keyword. See SORTWORK. |
SNAPERR | A B | Not applicable | A | Specify the SNAPERR keyword to instruct the API about how to react to errors when XBM is being used. Specify BYPASS or ABEND. If you specify BYPASS, the API bypasses errors as it does when XBM is not being used. If you specify ABEND, the job step will end with a 4094 abend. The default value is ABEND. |
SNAPSHOT | Y N | Not applicable | N | See SNAPSHOT. |
SNAPUNLD | Y N | SNAPUNLD(Y) SNAPUNLD(N) | N | Specify the software snapshot option:
|
SORT64 | N Y Y,N | SORT64(Y) SORT64(N) | N | Specify whether to use the BMC SORT component, with or without the zIIP Enablement component:
|
SORTPRM | ddname,ddname | Not applicable | DFSPARM $ORTPARM | Define the ddnames used by your sort product for sort commands. |
SORTWORK | (n,ccc,unitName,dataclas,mgmtclas,storclas) | Not applicable | 3,100,SYSDA | Dynamically allocate sort work data sets. |
SPILL | Y N | Not applicable | N | Specify SPILL option preference:
See SPILL. |
SSID | Not applicable | Not applicable | None | See SSID. |
STAOPEN | Y N | STAOPEN(Y) STAOPEN(N) | N | Specify whether you want to use the OPEN parameter on the /STA command:
|
STCJOBNM | One to seven characters that will be used as the prefix for the started task name | STCJOBNM(xxxxxxx) | JOBNAME | Specify the Job name prefix used when creating address spaces. See EXTSORT option in this table. Specify JOBNAME to force the use of the job name from the originating job. |
STRGCLAS | Not applicable | Any valid storage class | None | Specify the SMS storage class. |
SUBSYS | As many as four DBUSS IDs | One DBUSS ID | DBUZ DBUI | Specify a DBUSS name, if using. The DBUSS is used for APF-authorization only. |
SWAPWNDW | hhmm,hhmm
| SWAPWNDS(hhmm) SWAPWNDE(hhmm) | SWAP may occur at any time. | Used in CRF REORG to limit when the SWAP outage may occur. Specify a start and end time when CRF is to perform the SWAP. |
SYSOUT | * | SYSOUT(*) | * | Set a default SYSOUT class. There is no corresponding PLUSIN keyword. |
TEMPIC | 0 1 | TEMPIC(0) TEMPIC(1) | 0 | Specify whether to allow temporary data sets for image copy data sets:
|
TEMPUNIT | Any valid unit name | Any valid unit name | SYSALLDA | Assign a unit name for temporary data sets. |
TIME | (24,:) (12,:) | Not applicable | 24,: | Display the time in 24-hour format or 12-hour format, and use a colon to separate hours and minutes. In 24-hour format, 8:00 PM displays as 20:00. |
TIMEFORM | Not applicable | TIMEFORM(24) TIMEFORM(12) | 24 | Display the time in 24-hour format or 12-hour format. In 24-hour format, 8:00 PM displays as 20:00. |
TIMESEP | Not applicable | TIMESEP(:) | : | Specify the character to separate hours and minutes. Any nonblank character is valid. |
TRACE | 0 1 | Not applicable | 0 | Specify the FORCE BMCTRACE option:
|
TRACELIM | Not applicable | Not applicable | None | Specify the TRACE output limit in the following format: TRACELIM (ONLINE,BATCH)
The values are multiplied by 1000. |
TYPE | CSECT DSECT | Not applicable | CSECT | Specify the type:
|
UCBITMAP | Not applicable | Not applicable | NO | See UCBITMAP. |
ULPPRINT | Not applicable | Not applicable | BMCPRINT | See xxxPRINT. |
UNLAUTH | Y N | Not applicable | Y | Specify the DBRC authorization option for UNLOAD:
|
XBMSSID | Specify a 1- to 8-character name | XBMSSID(xxxxxxxx) | None | Specify the XBM SNAPSHOT subsystem ID. |
XIMGROUP | Specify a 1- to 8-characterracter name | XIMGROUP(xxxxxxxx) | DBUXIM00 | Specify the XIM group name. |
XSORTMEM | N Y,amount M,amount G,amount | Not applicable | N,000 | Specify whether to use the MEMLIMIT parameter when creating external address spaces for sort functions and, if so, specify the value to use for the parameter:
|
XSORTRGN | N Y,amount | Not applicable | N,000 | Specify whether to use the REGION parameter when creating address spaces for external sort functions and, if so, specify the value to use for the parameter:
|
XTNTOSAM | 1-60 | XTNTOSAM(1-60) | 0 | Specify the maximum OSAM extents the LOAD utility should acquire before issuing an error message and abending. |
XTNTVSAM | 1-120 | XTNTVSAM(1-120) | 0 | Specify the maximum VSAM extents the LOAD utility should acquire before issuing an error message and abending. |
ZIIPIO | N Y | ZIIPIO(Y) ZIIPIO(N) | N | Specify whether to use EXTENDED BUFFER MANAGER (EXTENDED BUFFER MANAGER for IMS) or SNAPSHOT UPGRADE FEATURE (SUF) to handle I/O operations on a zIIP processor:
|
Related topic