Contents

Chapter 1. Controlling and Monitoring

Processes..............1

Overview of the Command Line Interface ....1
Starting the CLI ............1
Stopping the CLI ............1
CLI Commands ............1
CLI Job Control ............3
CLI History Commands .........4
Overview of Sterling Connect:Direct Commands . 4
Submitting a Process...........6
Changing Process Parameters .......13
Deleting a Process from the TCQ ......15
Removing a Process from the Execution Queue 17
Stopping Sterling Connect:Direct ......18
Viewing a Process in the TCQ .......19
Monitoring Process Status in the TCQ ....22
Determining the Outcome of a Process ....26
Generating a Detailed Output Report for a
Process ...............32
Generating a Summary Report for a Process . . 33
Running System Diagnostics........33

Chapter 2. Process Queuing .....37

Overview of the Transmission Control Queue . . . 37
Scheduling Sterling Connect:Direct Activity....37
Progression of a Process Through the TCQ ....38
The Execution Queue ..........39
The Wait Queue............40
The Timer Queue ...........41
The Hold Queue............41

Chapter 3. Sterling Connect:Direct

Utilities ..............43

Introduction to Translation Tables.......43
Creating a Translation Table........43
Compiling a Translation TableUsing the ndmxlt
Utility ...............44
Example—Creating a Translation Table ....44
Example—Modifying a Model Translation Table 45
Using Translation During File Transfer
Operations .............45
Translation TableError Messages ......46
Accessing Sterling Connect:Direct Messages . . . 46
Message File Content ..........46
Message File Record Format........47
Displaying Message Text .........47
Precompressing/Decompressing Files Using the
Standalone Batch Compression Utility .....48
Special Considerations for Using the Standalone
Batch Compression Utility ........48
Using the Standalone Batch Compression Utility 49
Example—Precompress a TextFile ......51
Example—Precompress a TextFile With
Codepage Conversion ..........51
Example—Precompress a Binary File .....51
Example—Decompress a Text File......51
Examples—csdacomp Command Help ....52
Example—Decompress a File on the Remote
Node During the Copy Step........52
Example—Send Precompressed File to z/OS and
Storing It as Precompressed ........52
Validate Configuration Files .........53
Configuration Reports ...........53
Generating a Configuration Report on the Base
Installation .............54
Generating a Configuration Report on Sterling
Connect:Direct Secure Plus for UNIX .....55
Generating a Configuration Report on Sterling
Connect:Direct for SWIFTNet for UNIX ....56

Chapter 4. Writing Custom Programs 59

Introduction to Writing Custom Programs ....59
Compiling Custom Programs ........59
Writing Custom C Programs.........61
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() . 63
Receiving Responses Using ndmapi_recvresp() or
ndmapi_recvresp_c() ..........64
Sending a Command to Sterling Connect:Direct
Using ndmapi_sendcmd() or
ndmapi_sendcmd_c() ..........68
Writing Custom C++ Programs........69

Chapter 5. Writing User Exits .....75

User Exit Programs............75
User Exit Functions............75
Initializing Communications with exit_child_init()
or exit_child_init_c() ..........76
Waiting for a Message Using recv_exit_msg() or
recv_exit_msg_c() ...........77
Passing a File Descriptor Using send_exit_file()
or send_exit_file_c() ..........77
Sending a Message to Sterling Connect:Direct
Using send_exit_msg() or send_exit_msg_c() . . 78
Overview of User Exit Messages .......79
Statistics Exit Message..........79
File Open Exit Messages .........79
Security Exit Messages .........80
User Exit Stop Message .........82
Copy Control Block...........82
Exit Log Files..............82

Notices ..............83

Index ...............87

© Copyright IBM Corp. 1999, 2013 iii