Parameter Descriptions

DATABASE_TYPE=

type

Recommended. Specifies the type of source database and CDC that is associated with the registration or registrations that the PWXUCREG command processes. Options are:

ADA
. For Adabas.
DCM
. For Datacom table-based.
IDL
. For IDMS log-based.
IMS
. For IMS log-based. If you try to process registrations for IMS synchronous sources, the PWXUCREG utility rejects the registrations and ends with error message PWX-03723.

You can use the asterisk (*) wildcard, or a string followed by the wildcard such as B08*, in this parameter.

DATABASE_INSTANCE=

instance_id

Required. Specifies one of the following values that is defined for the registration group in the PowerExchange Navigator:

For Adabas, the collection identifier.
For Datacom, the MUF name.
For IDMS, the LOGSID identifier.
For IMS, the RECON identifier.

This value is case-sensitive. You can use the asterisk (*) wildcard, or a string followed by the wildcard, in this parameter.

EPWD=

encrypted_password

Specifies an encrypted password to use with the user ID that is specified in the associated USER parameter.

Consult with your system security administrator to determine the requirements for a user ID and a password or encrypted password based on your system security and the SECURITY statement in the DBMOVER configuration member.

You can use the PowerExchange Navigator to create an encrypted password. Click

File

Encrypt

.

If you specify this parameter, do not also specify the PWD parameter. If you specify both, the EPWD parameter takes precedence. Use the EPWD parameter if you are not allowed to store passwords in readable format.

Overrides the GLOBAL_EPWD parameter in a preceding SET_CONTROL_VALUE command, if specified.

GENERIC={

N

|Y}

Optonal. Enables you to issue registration-specific commands that change the registration status for multiple registrations that match a wildcard mask if you specify Y. You must also specify the asterisk (*) wildcard, or a string followed by the wildcard such as b80*, in one or more of the following registration-specific parameters: REGISTRATION_NAME, DATABASE_INSTANCE, and DATABASE_TYPE.

Default is N.

This parameter is not supported for any explicit DISPLAY_REGISTRATION command or automatic display operation based on the global DISPLAY_REGISTRATION_BEFORE_COMMAND and DISPLAY_REGISTRATION_AFTER_COMMAND parameters.

Overrides the global GENERIC parameter in a preceding SET_CONTROL_VALUE command.

PWD=

password

Specifies a nonencrypted password to use with the user ID that is specified in the associated GLOBAL_USER parameter. This value is case-sensitive.

Consult with your system security administrator to determine the requirements for a user ID and a password or encrypted password based on your system security and the SECURITY statement in the DBMOVER configuration member.

If you specify this parameter, do not also specify the EPWD parameter. If you specify both, the EPWD parameter takes precedence.

Overrides the GLOBAL_PWD parameter in a preceding SET_CONTROL_VALUE command, if specified.

REGISTRATION_LOCATION={

hlq.data_set_name

|

local

}

Optional. Specifies the location of the VSAM CCT data set that contains the capture registrations. Default value is "local."

Usually, the default value of "local" is acceptable because the capture registrations must reside on the z/OS source system where the PWXUCREG utility runs.

Overrides the GLOBAL_REGISTRATION_LOCATION parameter in a preceding SET_CONTROL_VALUE command, if specified.

REGISTRATION_NAME=

user_registration_name

Required. Specifies the user-defined name for the registration that is defined for the capture registration in the PowerExchange Navigator. This value is case-sensitive.

You can use the asterisk (*) wildcard, or a string followed by the wildcard, in this parameter.

USER=

user_id

Optional. Specifies a user ID that has the authority to access capture registrations in the CCT data set on the source system.

Consult with your system security administrator to determine the requirements for a user ID and a password or encrypted password based on your system security and the SECURITY statement in the DBMOVER configuration member.

This user ID value is case-sensitive.

If you specify this parameter, also specify either the EPWD or PWD parameter. If you specify both, the EPWD parameter takes precedence.

Overrides the GLOBAL_USER parameter in a preceding SET_CONTROL_VALUE command, if specified.

VALIDATE={

N

|Y}

Optional. Validates the command syntax and reads the registrations that match the selection criteria to ensure that the command can process them, if you specify Y. This parameter does not actually run the command to change the registration status. Default is N, which disables validation.