IBM 4J manual Contents

Page 5

Contents

Chapter 1. Controlling and Monitoring

 

 

Example—Precompress a Binary File . . . .

. 51

Processes

.

1

Example—Decompress a Text File

. 51

Overview of the Command Line Interface . . .

. 1

Examples—csdacomp Command Help . . .

. 52

Example—Decompress a File on the Remote

 

 

Starting the CLI

.

1

 

 

Node During the Copy Step

. 52

Stopping the CLI

.

1

Example—Send Precompressed File to z/OS and

 

 

CLI Commands

.

1

 

 

Storing It as Precompressed

.

52

CLI Job Control

.

3

Validate Configuration Files

.

53

CLI History Commands

. 4

Configuration Reports

.

53

Overview of Sterling Connect:Direct Commands

. 4

Generating a Configuration Report on the Base

 

 

Submitting a Process

.

6

 

 

Installation

.

54

Changing Process Parameters

. 13

Generating a Configuration Report on Sterling

 

 

Deleting a Process from the TCQ

. 15

 

 

Connect:Direct Secure Plus for UNIX . . . .

. 55

Removing a Process from the Execution Queue

 

17

 

Generating a Configuration Report on Sterling

 

 

Stopping Sterling Connect:Direct

.

18

 

 

Connect:Direct for SWIFTNet for UNIX . . .

. 56

Viewing a Process in the TCQ

. 19

 

 

 

Monitoring Process Status in the TCQ . . .

. 22

Chapter 4. Writing Custom Programs

 

59

Determining the Outcome of a Process . . .

. 26

 

Generating a Detailed Output Report for a

 

 

Introduction to Writing Custom Programs . . .

. 59

Process

.

32

Compiling Custom Programs

.

59

Generating a Summary Report for a Process .

. 33

Writing Custom C Programs

. 61

Running System Diagnostics

. 33

Creating a Connection to Sterling Connect:Direct

 

 

 

 

 

Using ndmapi_connect() or ndmapi_connect_c()

. 62

Chapter 2. Process Queuing

37

Terminating a Connection Using

. 63

Overview of the Transmission Control Queue . . . 37

ndmapi_disconnect() or ndmapi_disconnect_c()

Receiving Responses Using ndmapi_recvresp() or

 

Scheduling Sterling Connect:Direct Activity. . .

. 37

 

ndmapi_recvresp_c() . . . . . . . . . . 64

Progression of a Process Through the TCQ . . . . 38

Sending a Command to Sterling Connect:Direct

 

 

The Execution Queue

.

39

 

 

Using ndmapi_sendcmd() or

 

 

The Wait Queue

.

40

 

 

ndmapi_sendcmd_c()

.

68

The Timer Queue

.

41

Writing Custom C++ Programs

. 69

The Hold Queue

.

41

 

 

 

Chapter 3. Sterling Connect:Direct

 

 

Chapter 5. Writing User Exits

 

75

 

 

User Exit Programs

.

75

Utilities

43

User Exit Functions

.

75

Introduction to Translation Tables

.

43

Initializing Communications with exit_child_init()

 

Creating a Translation Table

.

43

 

or exit_child_init_c()

.

76

Compiling a Translation Table Using the ndmxlt

 

 

 

 

Waiting for a Message Using recv_exit_msg() or

 

 

Utility

.

44

 

 

recv_exit_msg_c()

.

77

Example—Creating a Translation Table . . .

. 44

Passing a File Descriptor Using send_exit_file()

 

 

Example—Modifying a Model Translation Table

 

45

 

 

 

or send_exit_file_c()

.

77

Using Translation During File Transfer

 

 

 

 

Sending a Message to Sterling Connect:Direct

 

 

Operations

.

45

 

 

Using send_exit_msg() or send_exit_msg_c() .

. 78

Translation Table Error Messages

.

46

Overview of User Exit Messages

. 79

Accessing Sterling Connect:Direct Messages . .

. 46

Statistics Exit Message

.

79

Message File Content

.

46

File Open Exit Messages

.

79

Message File Record Format

.

47

Security Exit Messages

.

80

Displaying Message Text

.

47

User Exit Stop Message

.

82

Precompressing/Decompressing Files Using the

 

 

 

 

Copy Control Block

.

82

Standalone Batch Compression Utility . . . .

. 48

Exit Log Files

.

82

Special Considerations for Using the Standalone

 

 

 

 

 

 

 

Batch Compression Utility

.

48

Notices

 

83

Using the Standalone Batch Compression Utility

 

49

 

 

 

 

 

Example—Precompress a Text File

. 51

Index

 

87

Example—Precompress a Text File With

 

 

 

Codepage Conversion

.

51

 

 

 

© Copyright IBM Corp. 1999, 2013

iii

Page 4 Page 6
Image 5
Page 4 Page 6
Contents User Guide Page User Guide Copyright IBM Corporation 1999 Contents Iv Sterling ConnectDirect for Unix User Guide CLI Commands Overview of the Command Line InterfaceStarting the CLI Stopping the CLIOption Description Value Entry Sample CommandCdpnum CLI Job ControlOverview of Sterling ConnectDirect Commands CLI History CommandsCommand Command Abbreviation DescriptionParameter Abbreviation Abbreviations for Common Sterling ConnectDirect CommandsParameter Description Values Submitting a ProcessPname = A?PROD5 Parameter Description Values Id , pswd Username@hostname or user@localhostName nnnnn Name host name nnn.nnn.nnn.nnn orSnodeid field Id ,pswd ,newpswdSpecify retain=initial Following command submits the Process named copyfil Following command submits the Process named payrollChanging Process Parameters Following command submits the Process named copy.cdpParameter Description Value Name generic listNode specification, userid generic list Remote node specification generic listDeleting a Process from the TCQ Number list Removing a Process from the Execution Queue Stopping Sterling ConnectDirect Flush process command has the following optional parametersParameter Description Viewing a Process in the TCQPname Locate the Process to view EX HC HE HI HO HR HS PE Monitoring Process Status in the TCQ Following command displays the specified Process numberAll EX HC HE HI HO HR HS PE Output from the command is displayed in the following table Dest=/path/file name Determining the Outcome of a ProcessRecord id list Caev Capr CAEV, CaprParameter Description Value Parameter Description Value Parameter Description Value Date day , hhmmss ampm Srcf=/path/file nameGenerating a Detailed Output Report for a Process Generating a Summary Report for a Process Running System DiagnosticsSelect Statistics Recid LOG Timepname Pnumber Stepname Ccod Fdbk MsgidCOMM.TRC Smgr Trace smgr pnode tnode=ath3500ry level=2 file=Smgp.trc Overview of the Transmission Control Queue Command DefinitionScheduling Sterling ConnectDirect Activity Scheduling Parameter Queue CommentsProgression of a Process Through the TCQ Execution Queue Status Comment Wait QueueElement Comment Hold Queue Timer QueueHeld for Call indicates that the Process was Creating a Translation Table Introduction to Translation TablesExample-Creating a Translation Table Compiling a Translation Table Using the ndmxlt UtilityExample-Modifying a Model Translation Table Using Translation During File Transfer OperationsAccessing Sterling ConnectDirect Messages Translation Table Error MessagesMessage File Content Diagnostic Number DescriptionMessage File Record Format Following is a sample ndmmsg commandDisplaying Message Text Following are the parameters for the message file recordSterling ConnectDirect for Unix User Guide Following are the parameters for the cdsacomp utility Using the Standalone Batch Compression UtilityLevel-Compression level Memory-The amountNnnnn Source codepage, destinationCodepage Example-Precompress a Text File With Codepage Conversion Example-Precompress a Text FileExample-Precompress a Binary File Example-Decompress a Text FileExamples-csdacomp Command Help Configuration Reports Validate Configuration FilesCfgcheck command has the following arguments Argument DescriptionType the following command at a Unix prompt Generating a Configuration Report on the Base InstallationSterling ConnectDirect Utilities Following example shows an excerpt from a sample report Sterling ConnectDirect Utilities Sterling ConnectDirect for Unix User Guide Introduction to Writing Custom Programs Program using the C++ API callsCompiling Custom Programs Compiler version to use for each platformYou want to create such as apicheck Platform Compile Command++ Function Description Writing Custom C ProgramsNdmerrenth Ndmerror NdmnoerrorNdmapirecvrespc Receiving Responses Using ndmapirecvresp or ndmapirecvrespcNdmapirecvresp or Parameter Description Value PNOD-PNODE SNOD-SNODE Following is a sample ndmapirecvresp functionReturn Code Description TruncatedNdmapirecvresp or ndmapirecvrespc to retrieve Ndmapisendcmdc function call has the following return codes Writing Custom C++ ProgramsFollowing is a sample ndmapisendcmd function Selectstatistics or Selectprocess , the CLISterling ConnectDirect for Unix User Guide Cdfailure Method Description Parameter Return ValuesCdsuccess = 0, Cdfailure = Following is the ConnectDirectSession class headerWriting Custom Programs Sterling ConnectDirect for Unix User Guide User Exit Functions User Exit ProgramsProgram Description Chown root exitskeletonReturn Code Goodrc ErrorrcExitprogram Waiting for a Message Using recvexitmsg or recvexitmsgcHeader Following are the parameters for sendexitmsg or sendexitmsgcFile Open Exit Messages Overview of User Exit MessagesStatistics Exit Message Fileopenoutputreplymsg Security Exit MessagesValidatemsg Validatereplymsg GeneratemsgExit Log Files User Exit Stop MessageCopy Control Block Copyright IBM Corp IBM Corporation J46A/G4 Bailey Avenue San Jose, CA Trademarks Sterling ConnectDirect for Unix User Guide Index Special characters Generatemsg Generatereplymsg Validatemsg Validatereplymsg Page Sterling ConnectDirect for Unix User Guide Page Product Number 5725-C99
Top Page Image Contents