Common Parameters for Registration-specific Commands
Common Parameters for Registration-specific Commands
Common parameters are grouped into the following categories:
Connectivity parameters that specify the location of the CCT file and credentials to use when accessing the file
Registration filter parameters that specify the database type, instance identifier, registration name, status, and versions of registrations to be processed
Other parameters such as GENERIC or VALIDATE that specify whether more than one registration will be processed, whether registrations are modified, whether attributes are displayed.
In the following parameter descriptions, curly brackets {} indicate that one of the options must be entered and underlining indicates the default value.
Connectivity Parameters
If several registration-specific commands run in the same command set, you can specify the following optional connectivity parameters globally in the SET_CONTROL_VALUE command instead of in the registration-specific command.
EPWD=
encrypted_password
Specifies an encrypted password to use with the user ID that is specified in the associated USER parameter.
Registration filter parameters apply to all commands except SET_CONTROL_VALUE. To filter the registrations, specify the following optional parameters.
DATABASE_TYPE=
type
Recommended. Specifies the type of source database and CDC method that is associated with the registration or registrations that the PWXUCREG command processes. Options are:
ADA
. For Adabas.
AS4
. For Db2 for i.
DB2
. For Db2 for z/OS.
DCM
. For Datacom table-based sources.
HAN
. For SAP HANA on Linux, UNIX, or Windows.
IDL
. For IDMS log-based sources.
IMS
. For IMS log-based and synchronous sources on z/OS.
MSS
. For Microsoft SQL Server on Windows.
MYS
. For MySQL on Linux, UNIX, or Windows.
ORA
. For Oracle on Linux, UNIX, or Windows.
PQS
. For PostgreSQL on Linux, UNIX, or Windows.
UDB
. For Db2 on Linux, UNIX, or Windows.
VSM
. For VSAM on z/OS.
Default is the asterisk (*) wildcard, which means all database types are selected.
Only IMS log-based uses an ECCR and supports suspending and reactivating registrations.
If you try suspending and reactivating registrations for IMS synchronous sources, the PWXUCREG utility rejects the registrations and ends with error message PWX-03723.
You can suspend and reactivate only registrations that have a database type of ADA, DCM, IDL, or IMS (log-based).
All database types can be processed by the DELETE-INATIVE_REGIRATION and DISPLAY_REGISTRATION commands.
DATABASE_INSTANCE=
instance_id
Recommended. The source database identifier that was specified for the registration group that contains the registrations in the PowerExchange Navigator. The identifier varies by database type:
For Adabas: Use the Collection Identifier value.
For Datacom: Use a MUF name.
For IDMS: Use a LOGSID identifier.
For IMS: Use the RECON identifier.
You can use the asterisk (*) wildcard, or a string followed by the wildcard, in this parameter.
Default is an asterisk (*) wildcard, which means all instances are selected.
REGISTRATION_NAME=
user_registration_name
Required. Specifies the user-defined name for the registration.
You can use the asterisk (*) wildcard, or a string followed by the wildcard, in this parameter.
If you are processing a single registration with the GENERIC=N parameter, the registration name must be fully specified without a wildcard.
Default is the asterisk (*) wildcard, which selects all names.
Other Parameters
To suspend or re-activate registrations for multiple registrations or validate registrations, specify the following optional parameters.
GENERIC={
N
|Y}
Issue registration-specific parameters that suspend or re-activate registrations for multiple registrations. Options are:
Y
. Commands to suspend or re-activate registrations can process multiple registrations. An asterisk (*) wildcard must be specified in a registration filter parameter including DATABASE_TYPE, DATABASE_INSTANCE, or REGISTRATION NAME.
N
. Commands to suspend or re-activate registrations can process only one registration at a time.