Command Reference

10.5.4
- 10.5.5
- 10.5.3
- 10.0

Back Next

pwxcmd fileswitch Command

Closes open condense files if they contain data and switches to a new set of PowerExchange Condense condense files. If the current condense files do not contain any data, the file switch does not occur.

Use this command to make change data in the current condense files available for extraction before the next file switch is due to occur. For example, to extract change data hourly from condense files, set the FILE_SWITCH_CRIT and FILE_SWITCH_VAL parameters in the CAPTPARM configuration file such that a file switch occurs after every one million record updates. Then include the fileswitch command as part of a batch job to perform an automated file switch hourly, before extraction processing runs.

If you perform both partial and full condense processing in a single PowerExchange Condense job, PowerExchange uses separate sets of condense files for the partial and full condense operations. When you issue the fileswitch command, a file switch occurs for both sets of condense files.

Use the following syntax:

pwxcmd fileswitch {-service|-sv} service_name 
                  [{-user|-uid|-u} user_ID] 
                  [{{-password|-pwd|-p} password|{-epassword|-e} encrypted_password}]

The following table describes pwxcmd fileswitch options and arguments:

Option	Argument	Description
-service -sv	service_name	Required. The service name for the PowerExchange Condense process.
-user -uid -u	user_ID	Required if you enable security. User name. If you specify a user name, you must also specify a -password or -epassword value, but do not specify both.
-password -pwd -p	password	A password for the specified user. If PowerExchange Condense runs on i5/OS or z/OS, you can enter a valid PowerExchange passphrase instead of a password. An i5/OS passphrase can be from 9 to 31 characters in length. A z/OS passphrase can be from 9 to 128 characters in length. A passphrase can contain the following characters: Uppercase and lowercase letters The numbers 0 to 9 Spaces The following special characters: ’ - ; # \ , . / ! % & * ( ) _ + { } : @ \| < > ? The first character is an apostrophe. Passphrases cannot include single quotation marks (‘), double quotation marks (“), or currency symbols. If a passphrase contains spaces, you must enclose it with double-quotation marks ("), for example, "This is a passphrase" . If a passphrase contains special characters, you must enclose it with triple double-quotation characters ("""), for example, """This passphrase contains special characters ! % & *.""" . If a passphrase contains only alphanumeric characters without spaces, you can enter it without delimiters. On z/OS, a valid RACF passphrase can be up to 100 characters in length. PowerExchange truncates passphrases longer than 100 characters when passing them to RACF for validation. To use passphrases, ensure that the PowerExchange Listener runs with a security setting of SECURITY=(1,N) or higher in the DBMOVER member. For more information, see "SECURITY Statement" in the PowerExchange Reference Manual .
-epassword -e	encrypted_password	An encrypted password for the specified user. If PowerExchange Condense runs on i5OS or z/OS, you can enter an encrypted PowerExchange passphrase instead of an encrypted password. Do not encrypt a passphrase that contains invalid characters, such as double-quotation marks, single quotation marks, or currency symbols.

Rename Saved Search

Table of Contents

Command Reference

Command Reference

pwxcmd fileswitch Command

pwxcmd fileswitch Command