Use DTLREXE DELETE to delete a file from the platform where the PowerExchange Listener is running.
DELETE has the following parameters:
loc
Required. Location of the PowerExchange Listener as defined in a NODE statement in the DBMOVER configuration file.
parms
Required. The name of the file to delete. On z/OS, if you do not enclose the name in quotes, the utility provides them.
prog
Required. Set to DELETE.
config
Optional. The DBMOVER configuration file that you want the DTLREXE utility to use, when you do not want to use the default DBMOVER file or the DBMOVER file that is set in the PWX_CONFIG environment variable. This parameter is used only when you run DTLREXE on Linux, UNIX, and Windows. This parameter is ignored on IBM i or z/OS.
{pwd|epwd}
Optional. A password or encrypted password for the specified user ID. For a location on i5/OS or z/OS, you can enter a passphrase or encrypted passphrase instead.
pwd
. A clear text password for the specified user, which allows access to the target. If a password contains nonalphanumeric characters, it must be enclosed in double quotation marks (“). A password cannot contain embedded double quotation marks.
For access to an i5/Os or z/OS location, you can enter a valid PowerExchange passphrase instead of 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.
To use passphrases, ensure that the PowerExchange Listener runs with a security setting of SECURITY=(1,N) or higher in the DBMOVER configuration member. On z/OS, the DTLCFG DD statement in the DTLREXE JCL points to the DBMOVER member. On i5/OS, the DBMOVER member is the CFG file in the PowerExchange
datalib
library. For more information, see "SECURITY Statement" in the
PowerExchange Reference Manual
.
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.
epwd
. An encrypted password for the specified user.
For access to an i5/OS or z/OS location, 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.
You can use the PowerExchange Navigator to encrypt a password or passphrase.
uid
Optional. A user ID that allows access to the specified location. If you specify a user ID, you must also enter a
pwd
or
epwd
value, but do not enter both.
For a location on a supported Linux, UNIX, or Windows system, if you have enabled PowerExchange LDAP user authentication, the user ID is the enterprise user name. For more information, see the