IBM 4J 20

Parameter Description Value

pname Locate the Process to view

by Process name.

The Process name is limited

to 8 characters on Sterling

Connect:Direct for Microsoft

Windows and Sterling

Connect:Direct for z/OS.

name |generic |(list)

name—Specifies the Process name, up to 8

alphanumeric characters.

generic—Specifies a nonspecific value for the

Process name. This generic value, containing

pattern-matching characters, evaluates to a

list of zero or more pname strings.

list—Specifies a list of Process names. Enclose

the list in parentheses, and separate each

value with a comma.

pnumber Locate the Process to view

by Process number. Sterling

Connect:Direct assigns the

Process number when the

Process is submitted.

number from 1–99,999 |(list)

number—Specifies the Process number.

list—Specifies a list of Process numbers.

Enclose the list in parentheses, and separate

each value with a comma.

queue Specifies the Processes to be

viewed by the specified

queue names.

all | exec | hold | wait | timer

all—Selects Processes from all queues. This is

the default.

exec—Selects Processes from the Execution

queue.

hold—Selects Processes from the Hold queue.

timer—Selects Processes from the Timer

queue.

wait—Selects Processes from the Waitqueue.

snode View the Process by the

secondary node name. This

parameter can be used to

specify a specific remote

node, a generic value for

matching remote node

names (using pattern

matching), or a list of

multiple remote node names.

The secondary node name

typically contains the 1–16

character remote Sterling

Connect:Direct node name,

but can be any string up to

256 alphanumeric characters

long. You can also specify a

remote node name as an IP

address or hostname and a

port number.

remote node specification |generic |(list)

remote node specification—Identifies a

specific remote node name.

generic—Specifies a nonspecific value for the

remote node name. This generic value,

containing pattern-matching characters,

evaluates to a list of zero or more remote

node names.

list—Specifies a list of remote node

specifications. Enclose the list in parentheses,

and separate each value with a comma.

20 Sterling Connect:Direct for UNIX: User Guide

Contents

Main Page Page Page Contents Chapter 1. Controlling and Monitoring Processes..............1 Chapter 2. Process Queuing .....37 Chapter 3. Sterling Connect:Direct Utilities ..............43 Chapter 4. Writing Custom Programs 59 Page Chapter 1. Controlling and Monitoring Processes Overview of the Command Line Interface Starting the CLI Stopping the CLI CLI Commands 2 CLI Job Control CLI History Commands Overview of Sterling Connect:Direct Commands 4 Abbreviations for Common Sterling Connect:Direct Commands Restricting the Scripts and UNIX Commands Users Can Execute Sterling Connect:Direct Command Syntax Generic Parameter Value List Parameter Value Submitting a Process Page 8 Page 10 Page Example - Submit a Process That Runs Every Week The following command submits the Process named payroll: 12 Example - Submit a Process with a Start Time Specified The following command submits the Process named copyfil: Changing Process Parameters The optional parameters for the change process command are the following: 14 Deleting a Process from the TCQ The delete process command removes a nonexecuting Process from the TCQ. 16 The following command deletes all nonexecuting Processes submitted by user ID cduser on node dallas: Removing a Process from the Execution Queue The flush process command has the following optional parameters: The following command flushes all executing Processes named Rome from the Execution queue: The following command flushes all executing Processes on node alma submitted by user ID jones: Stopping Sterling Connect:Direct 18 Viewing a Process in the TCQ 20 Page The following command displays the specified Process number: Monitoring Process Status in the TCQ 22 Page 24 The following command displays a short report for the specified Process number: Output from the command is displayed in the following table: The following command displays a detailed report for the specified Process number: Output from the command is displayed in the following table: Determining the Outcome of a Process 26 Page 28 Page 30 Page Generating a Detailed Output Report for a Process 32 Generating a Summary Report for a Process Running System Diagnostics 34 Page 36 Chapter 2. Process Queuing Overview of the Transmission Control Queue Scheduling Sterling Connect:Direct Activity Progression of a Process Through the TCQ 38 The Execution Queue The Wait Queue 40 The Timer Queue The Hold Queue 42 Chapter 3. Sterling Connect:Direct Utilities Introduction to Translation Tables Creating a Translation Table Compiling a Translation Table Using the ndmxlt Utility 44 The parameters for the ndmxlt command are listed in the following table: ExampleCreating a Translation Table About this task ExampleModifying a Model Translation Table About this task Using Translation During File Transfer Operations Translation Table Error Messages Accessing Sterling Connect:Direct Messages 46 Message File Content Message File Record Format Displaying Message Text Precompressing/Decompressing Files Using the Standalone Batch Compression Utility Special Considerations for Using the Standalone Batch Compression Utility 48 Using the Standalone Batch Compression Utility Following are the parameters for the cdsacomp utility: 50 ExamplePrecompress a Text File ExamplePrecompress a Text File With Codepage Conversion ExamplePrecompress a Binary File ExampleDecompress a Text File Examplescsdacomp Command Help Requesting a summary of cdsacomp command parameters and help options: 52 ExampleDecompress a File on the Remote Node During the Copy Step ExampleSend Precompressed File to z/OS and Storing It as Precompressed Validate Configuration Files Configuration Reports Generating a Configuration Report on the Base Installation 54 Generating a Configuration Report on Sterling Connect:Direct Secure Plus for UNIX The following example shows an excerpt from a sample report: Generating a Configuration Report on Sterling Connect:Direct for SWIFTNet for UNIX 56 Page Page Chapter 4. Writing Custom Programs Introduction to Writing Custom Programs Compiling Custom Programs 60 Writing Custom C Programs Creating a Connection to Sterling Connect:Direct Using ndmapi_connect() or ndmapi_connect_c() 62 Terminating a Connection Using ndmapi_disconnect() or ndmapi_disconnect_c() Receiving Responses Using ndmapi_recvresp() or ndmapi_recvresp_c() 64 Following are the parameters for ndmapi_recvresp() or ndmapi_recvresp_c(): Page 66 The ndmapi_recvresp() or ndmapi_recvresp_c() function has the folliowing return codes: Following is a sample ndmapi_recvresp() function: Sending a Command to Sterling Connect:Direct Using ndmapi_sendcmd() or ndmapi_sendcmd_c() 68 Following are the parameters for ndmapi_sendcmd() or ndmapi_sendcmd_c(): Writing Custom C++ Programs 70 The ConnectDirectSession class methods are described in the following table: Page Following is the ConnectDirectSession class header: 72 Page Page Chapter 5. Writing User Exits User Exit Programs User Exit Functions Initializing Communications with exit_child_init() or exit_child_init_c() 76 The exit_child_init() or exit_child_init_c() function has the following parameter: Waiting for a Message Using recv_exit_msg() or recv_exit_msg_c() Passing a File Descriptor Using send_exit_file() or send_exit_file_c() Sending a Message to Sterling Connect:Direct Using send_exit_msg() or send_exit_msg_c() 78 Overview of User Exit Messages Statistics Exit Message File Open Exit Messages FILE_OPEN_OUTPUT_MSG FILE_OPEN_OUTPUT_REPLY_MSG Security Exit Messages GENERATE_MSG GENERATE_REPLY_MSG VALIDATE_MSG VALIDATE_REPLY_MSG User Exit Stop Message 82 Copy Control Block Exit Log Files Notices 84 Trademarks 86 Index Special characters A C D E I L 88 M N V W