Table of Contents

Search

  1. Preface
  2. Introduction to PowerExchange Utilities
  3. createdatamaps - Data Map Creation Utility
  4. DTLCCADW - Adabas PCAT Utility
  5. DTLCUIML - IMS Log Marker Utility
  6. DTLINFO - Release Information Utility
  7. DTLREXE - Remote Execution Utility
  8. DTLUAPPL - Restart Token Utility
  9. DTLUCBRG - Batch Registration Utility
  10. DTLUCDEP - CDEP Maintenance Utility
  11. DTLUCSR2 - IDMS SR2 and SR3 Records Utility
  12. DTLUCUDB - DB2 for Linux, UNIX, and Windows CDC Utility
  13. DTLULCAT and DTLULOGC - IDMS Log Catalog Utilities
  14. DTLURDMO - Data Map Utility
  15. DTLUTSK - Task Control Utility
  16. EDMLUCTR - Log Scan and Print Utility
  17. EDMXLUTL - Event Marker Utility
  18. HOSTENT - TCP/IP Address Reporter Utility
  19. PWXCATMY - MySQL Catalog Utility
  20. PWXUCCLPRT - Print Log Summary Utility
  21. PWXUCDCT - Logger for Linux, UNIX, and Windows Utility
  22. PWXUCREG - Capture Registration Suspend Utility
  23. PWXUCRGP - Capture Registrations Print Utility
  24. PWXUDMX - Data Maps Update Time ECSA Memory Utility
  25. PWXUGSK - SSL Reporting Utility for z/OS
  26. PWXUMAP - Map List Utility
  27. PWXUSSL - PowerExchange SSL Reporting Utility

DTLUTSK Command Line Utility on Linux, UNIX, and Windows

DTLUTSK Command Line Utility on Linux, UNIX, and Windows

Use the following syntax and parameters to run the DTLUTSK utility on a Linux, UNIX, or Windows system:
Syntax:
DTLUTSK   CMD=
command_name
  [TASKID=
task_id
]   [APPL=
task_name
]   [NODETYPE={
N
|A|S}    LOC=
location
  [UID=
user_id
]   [PWD=
password_or_passphrase
]
Parameters:
The following table describes the parameters:
Parameter
Description
CMD
  • LISTTASK
    . Lists all current tasks.
  • STOPTASK
    . Stops the task specified by TASKID parameter.
  • LISTLOCATIONS
    . Lists all current locations.
  • LISTALLOC
    . Lists the data sets allocated to a PowerExchange Listener on z/OS. Specify the remote z/OS node in the LOC parameter. If you attempt to run the command against a Listener on i5/OS, Linux, Unix, or Windows, the result set will be empty.
    Alternatively, instead of issuing the LISTALLOC command from the command line, you can specify the LISTALLOC command in the
    Pre SQL
    or
    Post SQL
    attribute for a PowerCenter session to report file allocations when the workflow runs. Also specify the PowerCenter
    Retrieve PWX Log Entries
    connection attribute to enable the informational messages with file-allocation information to be written the session log.
TASKID
When CMD=STOPTASK, the task ID of the task that you want to stop. You can determine the task ID by using the LISTTASK command.
APPL
When CMD=STOPTASK, the task name of the task that you want to stop. You can determine the task ID by using the LISTTASK command.
NODETYPE
When CMD=LISTLOCATIONS, specify one of the following node types:
  • N
    . List locations that are defined in NODE statements in the DBMOVER configuration file.
  • A
    . List locations that are defined in NODE or SVCNODE statements in the DBMOVER configuration file.
  • S
    . List locations that are defined in SVCNODE statements in the DBMOVER configuration file.
Default is N.
LOC
The remote location where the task is running or where the allocated data sets exist. Locations must be specified in NODE statements in the DBMOVER configuration file. If you enter LOCAL, the utility returns an error message.
UID
A user ID that has the authority to access the location, if required by your security settings.
For a location on a supported Linux, UNIX, or Windows system, if you have enabled PowerExchange LDAP user authentication, the user name is the enterprise user name. For more information, see the
PowerExchange Reference Manual
.
PWD
A password or encrypted password for the specified user. If a password contains nonalphanumeric characters, you must enclose it in double quotation marks (“). Do not include double quotation marks within a password string, even if you enclose it in double quotation marks.
For access to a remote i5/OS or z/OS location, 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. Passphrases 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.
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.
If a passphrase contains spaces, enclose it in double quotation marks ("). If a passphrase contains special characters, enclose it in triple double-quotation marks (""").
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
.
Example Output:
2003-06-27 14:20:25 TASK LIST Name Taskid Partner Port Status Acc_Method ============================================================================== 0740 Active RPX 1688 Active TASK_CNTL

0 COMMENTS

We’d like to hear from you!