CONVERT command parameters
The following parameters are available to use with CONVERT command conversions.
IMS HALDB Toolkit ignores any parameters that are unavailable for the requested process.
Parameter | Requirement | Description |
---|---|---|
ACBGEN | Optional |
Specifies to run the ACBGEN process during the takeover phase. When IMS manages the ACBs (ACBMGMT=CATALOG), ACBGEN(N) is forced.
|
BYTELIM | Optional |
Specifies a new maximum-insert-byte for the DBD.
|
CONST | Optional |
Used as a substitute for the DBD name when building partition names. See also DBDPATT, INDPATT, and FIRSTPART parameters.
|
DATACLAS | Optional |
Specifies the name of the data class for the new SMS-managed databases and image copy data sets that IMS HALDB Toolkit dynamically allocates.
|
DATACLSL | Optional |
Specifies the name of the data class for the new SMS-managed ILDS data sets that IMS HALDB Toolkit dynamically allocates. If the database data sets of the primary database, from which the ILDS data sets are created, are encrypted OSAM data sets and have the Extended Addressability attribute, you must specify a data class without the Extended Addressability attribute for the ILDS data sets. If the database data sets, from which the ILDS data sets are created, do not have the Extended Addressability attribute, this parameter is ignored.
|
DBD | Required |
Specifies which full-function database is to be converted.
|
DBDBACKUP | Optional |
Backs up the existing DBD to a specified library. This parameter includes a DDNAME that must be included in the JCL. When IMS manages the ACBs (ACBMGMT=CATALOG), this parameter is ignored.
|
DBDCOPY | Optional |
Copies the new DBD to your DBD library. If NEWDBD is not specified, DBDCOPY is set to Y. When IMS manages the ACBs (ACBMGMT=CATALOG), DBDCOPY(N) is forced.
|
DBDPATT | Optional |
Creates a partition name from the DBD.
|
DBDSOURCE | Optional |
Generates the DBD source for the converted HALDB and places it in the specified library. This parameter includes a DDNAME that must be included in the JCL. The data set that you specify for dbdsource DD must be a partitioned data set (PDS) or a partitioned data set extended (PDSE) with LRECL=80 and RECFM=F. SYSOUT=* cannot be specified for this data set.
|
DBRCBACK | Optional |
Backs up the existing DBRC to a specified library. This parameter includes a DDNAME that must be included in the JCL. The data set that you specify for dbrcback DD must be a partitioned data set (PDS) or a partitioned data set extended (PDSE) with LRECL=80 and RECFM=F. SYSOUT=* cannot be specified for this data set.
|
DBRCOUT | Optional | Specifies the name of the DD to which IMS HALDB Toolkit
prints DBRC commands. Specify this parameter to generate DBRC commands. You must also specify the dbrcout DD statement in the JCL. You can specify SYSOUT=*, a sequential file, or a partitioned data set (PDS) or a partitioned data set extended (PDSE) with a member name with LRECL=80 and RECFM=F to the dbrcout DD.
|
DFSDF | Optional |
Specifies the 3-character suffix of the DFSDFxxx member of the IMS PROCLIB data set that contains the settings and attributes of the IMS catalog. The specified member is used when the following two conditions are met:
|
DSG1 | Optional |
Changes a database with multiple data set groups into a database with a single data set group.
|
DSNDBD | Optional |
Specifies the suffix portion of the new data set name that you are using. A total of 37 characters are allowed for the entire data set name, which includes the characters used for the DSNPREF prefix and the characters used for the DSNDBD suffix.
|
DSNPREF | Required |
Specifies a high-level data set name to be used when building new partition data set names. The DBRC DSNPREFX parameter is created from this specification and appended with the DBD name. The final data set name is then appended by DBRC with the DBD file letter and the partition number.
|
FBFF | Optional |
Specifies a new free block frequency factor (FBFF) to be used when defining a partition.
|
FIRSTPART | Optional |
Identifies the partition name extension to be added to the name "stub" created by the DBDPATT and INDPATT parameters. The "stub" and the extension cannot exceed 7 characters.
|
FSPF | Optional |
Specifies a new free space percentage value per interval or block (FSPF) to be used when defining a partition.
|
GDGLIMIT | Optional |
Specifies the maximum number of GDG (generation data group) data sets that can be associated with the GDG. This value is used only when the GDG base does not exist and a GDG is created during the job. IMS HALDB Toolkit uses the value specified for this parameter when a GDG is requested for image copy data sets. If you specify one of the following parameters, the existence of a GDG base is verified before the image copy data set is allocated:
If a GDG base does not exist, IMS HALDB Toolkit automatically defines one using the GDGLIMIT parameter value to control the number of generations to keep.
|
IC.COMP | Optional |
Used for IMS High Performance Image Copy processing. This parameter specifies whether compression is used. If the copy is a standard image copy, this parameter is ignored.
|
IC.COMPRTN | Optional |
Used for IMS High Performance Image Copy processing. If IC.COMP(Y) is used, this parameter specifies the name of a compression routine. If the copy is a standard image copy, this parameter is ignored.
|
IC.VIC | Optional |
Specifies whether a virtual image copy is taken. Specify Y to activate IC.VIC and suppress the creation of image copies for all PSINDEXes. A NOTIFY.UIC is used instead.
|
IC.VICDSN | Optional |
Activated only when IC.VIC(Y) is also specified. Specifies a string of up to 44 characters that are used as UDATA for the NOTIFY.UIC. The string must conform to z/OS® and IMS data set name rules.
|
IC1DSN | Optional |
This parameter provides an alternative to using the ICHLQ, ICID, ICMID, and ICTRLR parameters to specify the data set name for an image copy.
|
IC2DSN | Optional |
Specifies the secondary image copy data set name. To create the data set name, use the same method that is described for the IC1DSN keyword. You must specify a unique data set name.
|
ICHLQ | Optional |
Specifies the high-level qualifier for the image copy data sets.
|
ICID | Optional |
Used to override the default (IC1 or IC2) for the suffix qualifier for dual image copy data sets.
|
ICMID | Optional |
Specifies the mid-level data set qualifier for image copy data sets.
|
ICNUM | Optional |
Specifies single or dual image copies.
|
ICOFF | Optional |
Specifies that no image copies are to be taken, and turns off the ICNEEDED parameter.
|
ICTRLR | Optional |
Specifies whether to use another final suffix qualifier for image copy data sets.
|
ICVOLCT | Optional |
Use this keyword to specify the number of volumes to allocate for image copy data sets. If an image copy data set requires more space than is available on a single volume, specify a value larger than 1. The ICVOLCT value is applied to all image copy data sets that are dynamically defined in the IMS HALDB Toolkit job.
|
IMSID | Optional |
Specifies the IMS ID to use when updating the IMS Library Integrity Utilities partition description. IMSID must be specified when the IMS catalog is enabled by the IMS Catalog Definition exit routine and IMSID is referred to in the exit routine.
|
INDPART | Optional |
Specifies the number of index partitions. Cannot be used with INDSIZE.
|
INDPATT | Optional |
Creates a partition name "stub" from the DBD name of a secondary index.
|
INDPRIM | Optional |
Specifies whether a secondary index is partitioned the same as the primary database. The following restrictions apply:
|
INDSIZE | Optional |
Specifies the size of each index partition. Cannot be used with INDPART.
|
INITDB | Optional |
DDNAME in JCL that allows parameters to be added to the DBRC INIT.DB command, which are not currently specified by the product. This parameter can be specified in stream or in a data set. If no parameters are added, the defaults for the Global Service Group (GSG) are used. If specified, this parameter requires a DDNAME which must be included in the JCL. Any DBRC statements that you specify on the initdb_dd DD statement are included in the statements that are generated by the product. DBRC statements coded on the initdb_dd DD statement must conform to the syntax of the INIT.DB command. For the syntax rules, see the topic "INIT.DB command" in IMS Commands.
|
INITPART | Optional |
DDNAME in JCL that allows parameters to be added to the DBRC INIT.PART command, which are not currently specified by the product. IMS HALDB Toolkit uses the defaults for GENMAX, DFLTJCL, ICJCL, OICJCL, RECOVJCL, RECOVPD, RECVJCL, and NOREUSE. Any DBRC statements that you specify on the initpart_dd DD statement are included in the statements that are generated by the product. DBRC statements coded on the initpart_dd DD statement must conform to the syntax of the INIT.PART command. For the syntax rules, see the topic "INIT.PART command" in IMS Commands.
|
KEYLABEL | Optional | Specifies the encryption key label for encrypting dynamically
allocated database data sets and image copy data sets. The key label can be up to 64 bytes.
|
KEYLEN | Optional |
Specifies the length of the subkey when IHCPSEL0 is used. For example, to partition by country, using a country code that is 3 characters in position 7-9 of your key, specify the following:
|
KEYOFF | Optional |
Specifies the offset within the root segment key to be used when IHCPSEL0 has been specified as PARTSEL. The offset must be at least 1. Offset 0 does not need a partition selection exit. For example, to partition by country, using a country code that is 3 characters in position 7-9 of your key, specify the following:
|
KEYS | Optional |
Specifies a DD statement which contains records for the high keys; cannot be used with PARTNUM or PARTSIZE. This parameter can be specified as a character or hexadecimal. Specifying KEYS results in as many partitions as there are keys specified in the file. The specifications are analyzed to determine whether the requested partitioning is feasible. If the number of partitions has been specified, IMS HALDB Toolkit verifies that no partition is larger than 4 GB. If the high keys are created during analysis, there must be at least as many database records as there are requested partitions.
|
MGMTCLAS | Optional |
Specifies a new SMS management class.
|
NEWDBD | Optional |
Specifies the DDNAME of the data set that contains the changed HALDB DBDs. This parameter is a DDNAME, which must be included in the JCL. If NEWDBD is not specified, a temporary data set is used. DBDCOPY is then reset to Y. When IMS manages the ACBs (ACBMGMT=CATALOG), this parameter is ignored.
|
ONLINE | Optional |
Specifies whether the batch conversion is to be performed while the databases remain online. ONLINE(Y) is not supported by IMS Database Utility Solution.
|
OSAM | Optional |
Converts VSAM to OSAM.
|
OVFLINCR | Optional |
Increases HDAM overflow area by a number of blocks.
|
PARTNUM | Optional |
Specifies the number of partitions to be created. PARTNUM cannot be used with PARTSIZE or KEYS. Specifying this parameter causes IMS HALDB Toolkit to find the high keys. The specifications are analyzed to determine whether the requested partitioning is feasible. PARTNUM might not result in the exact number of partitions specified because a root segment and all of its dependent segments must be written to the same partition. Therefore, fewer than PARTNUM partitions might be created so that hierarchical integrity is preserved. If the number of partitions has been specified, IMS HALDB Toolkit verifies that no partition is larger than 4 GB. If the high keys are created during analysis, there must be at least as many database records as there are requested partitions.
|
PARTSEL | Optional |
Specifies a partition selection routine to be used. This parameter must be used with the KEYS parameter. IMS HALDB Toolkit provides an exit for partition selection (IHCPSEL0). When you use this exit, the database is partitioned using a subset of the key. If you use IHCPSEL0, you must also select the KEYOFF and KEYLEN parameters.
|
PARTSIZE | Optional |
Specifies the size of partitions that are created. PARTSIZE cannot be specified with PARTNUM or KEYS. Specifying the PARTSIZE parameter causes IMS HALDB Toolkit to find the high keys. The specifications are analyzed to determine whether the requested partitioning is feasible.
|
PTRCHECK | Optional |
Performs pointer checking during image copy. This parameter is ignored when using the standard IMS image copy.
|
RAAINCR | Optional |
Increases HDAM root addressable area (RAA) by a specified number of blocks.
|
RAPS | Optional |
Specifies new PHDAM root anchor points (RAPs).
|
RELOAD.DBIOBUF | Optional |
Used for IMS High Performance Load processing. Specifies the number of tracks for the access method (VSAM or BSAM) buffers that are used for one database data set group when the database is read or written to. If the load is a standard HD Load, this parameter is ignored. For details, see the IMS High Performance Load User's Guide.
|
RELOAD.DBRLBUF | Optional |
Used for IMS High Performance Load processing. Specifies the number of database buffers (the number of tracks) to be used for one database data set group when the database is read or written to. If the load is a standard HD Load, this parameter is ignored. For details, see the IMS High Performance Load User's Guide.
|
RELOAD.FRSPC | Optional |
Used for IMS High Performance Load processing. Specifies whether IMS HP Load secures free space according to the specification of the FRSPC parameter in DBD. If the load is a standard HD Load, this parameter is ignored. For details, see the IMS High Performance Load User's Guide.
|
RELOAD.HPIO | Optional |
Used for IMS High Performance Load processing. Specifies whether IMS HP Load uses the High Performance I/O Driver for output database data sets. If the load is a standard HD Load, this parameter is ignored. For details, see the IMS High Performance Load User's Guide.
|
RELOAD.OADSPR | Optional |
Used for IMS High Performance Load processing. Specifies whether IMS HP Load reduces the usage of data space when processing the overflow area by using the High Performance I/O driver or by using an OVERFLOW DD. This specification is valid only for HDAM or PHDAM databases. If the load is a standard HD Load, this parameter is ignored. For details, see the IMS High Performance Load User's Guide.
|
RELOAD.RAAFORMAT | Optional |
Used for IMS High Performance Load processing. Specifies whether IMS HP Load is to format HDAM or PHDAM RAA blocks regardless of the number of blocks used. Once the overflow area is used, this parameter is ignored and the entire RAA is formatted. This specification is valid only for HDAM or PHDAM databases. If the load is a standard HD Load, this parameter is ignored. For details, see the IMS High Performance Load User's Guide.
|
RELOAD.SEARCH | Optional |
Used for IMS High Performance Load processing. Specifies the limit value for a space search algorithm that finds a segment that does not fit in its home block. This specification is valid for HDAM or PHDAM databases. If the load is a standard HD Load, this parameter is ignored. For details, see the IMS High Performance Load User's Guide.
|
RELOAD.SORT | Optional |
Used for IMS High Performance Load processing. Specifies whether to run the physical sequential sort processing before loading. This specification is valid only for HDAM and PHDAM databases. If the load is a standard HD Load, this parameter is ignored. For details, see the IMS High Performance Load User's Guide.
|
RELOAD.SORTHIDAM | Optional |
Used for IMS High Performance Load processing. Specifies whether to run the sort processing before loading a HIDAM or a PHIDAM. If the load is a standard HD Load, this parameter is ignored. For details, see the IMS High Performance Load User's Guide.
|
RELOAD.USEREXIT | Optional |
Used for IMS High Performance Load processing. Specifies whether IMS HP Load invokes a user exit routine. If the load is a standard HD Load, this parameter is ignored. For details, see the IMS High Performance Load User's Guide.
|
SORTFSZ | Optional |
Specifies the estimated number of database records. The value is specified as FILSZ=Ex of OPTION control statement when calling sort processing. If SORTFSZ is not specified, IMS HALDB Toolkit estimates the number of database records.
|
STORCLAS | Optional |
Specifies the name of the storage class for the new SMS-managed databases and image copy data sets that IMS HALDB Toolkit dynamically allocates.
|
TAKEOVER.FILE | Optional |
Saves the takeover statements (DBRC and IDCAMS) to a specified data set. You can specify SYSOUT=*, a sequential file, or a partitioned data set (PDS) or a partitioned data set extended (PDSE) with LRECL=80 and RECFM=F.
|
UNLSPAC | Optional |
Specifies a 4-digit numeric space allocation value for temporary data set allocations, for example, the unload file. Specify a numeric value for the number of cylinders to allocate to each temporary data set. If the number of cylinders to allocate to each temporary data set is omitted, IMS HALDB Toolkit determines the optimal value. The number of data sets that are allocated is determined by IMS HALDB Toolkit.
|
UNLUNIT | Optional |
Specifies any valid direct-access 8-character unit name for temporary data set allocations, for example, the unload file. These files are temporary files that default to SYSALLDA, unless otherwise specified.
|
VOLALLO | Optional |
Used to override the space allocation when creating the database data sets.
|
VOLALLOL | Optional |
Used to override the space allocation when creating the ILDS data sets.
|
VOLALLOX | Optional |
Used to override the space allocation when creating the primary index data sets.
|