Sterling ConnectDirect for Unix User Guide | IBM 4J instruction

Note: The environment variable NDMAPICFG must be set to the pathname of the client configuration file. Refer to “Starting the CLI” on page 1for instructions on setting the environment variable.

To use the ConnectDirectSession class, your application must include the cdunxsdk.h header file provided in the installation and must link with the ndmapi.a file. Following is a sample ConnectDirectSession class program:

#include "cdunxsdk.h" #include <iostream.h> #include <string.h>

void getError(ConnectDirectSession& cdSess); main()

{

ConnectDirectSession cdSess; char processText[16384];

if (cdSess.SessionINF->Connect() == CD_SUCCESS)

{

strcpy(processText,"submit maxdelay=unlimited sdksample process snode=SNODENAME "); strcat(processText,"copy00 copy from (file=sample.txt pnode)");

strcat(processText,"to (file=sample.000 snode disp=rpl) ;"); if (cdSess.SessionINF->SendCommand(processText) == CD_SUCCESS)

{

printf("%s completed, pnumber = %ld.\n", cdSess.SessionINF->GetCommandName(), cdSess.SessionINF->GetProcessNumber());

sprintf(processText, "SELECT STATISTICS PNUMBER=%ld DETAIL=YES ;", cdSess.SessionINF- >GetProcessNumber());

(cdSess.SessionINF->SendCommand(processText) == CD_SUCCESS)

{

}

else

{

getError(cdSess);

}

}

else

{

getError(cdSess);

}

cdSess.SessionINF->DisConnect();

}

else

{

getError(cdSess);

}

}

void getError(ConnectDirectSession& cdSess)

{

if (cdSess.SessionINF->GetFirstError())

{

printf("\nError Message:	%s",	cdSess.SessionINF->GetMsgID());
printf("\nError Feedback:	%d",	cdSess.SessionINF->GetFeedBackCode());
printf("\nError RC:	%d",	cdSess.SessionINF->GetReturnCode());
printf("\nError SUBST:	%s\n", cdSess.SessionINF->GetSubstitute());		}
while(cdSess.SessionINF->GetNextError())
{
printf("\nError Message:	%s",	cdSess.SessionINF->GetMsgID());
printf("\nError Feedback:	%d",	cdSess.SessionINF->GetFeedBackCode());
printf("\nError RC:	%d",	cdSess.SessionINF->GetReturnCode());
printf("\nError SUBST:	%s\n", cdSess.SessionINF->GetSubstitute());
}

}

The ConnectDirectSession class methods are described in the following table:

70Sterling Connect:Direct for UNIX: User Guide

Image 76

IBM 4J manual Sterling ConnectDirect for Unix User Guide

Contents

User Guide Page User Guide Copyright IBM Corporation 1999 Contents Iv Sterling ConnectDirect for Unix User Guide Overview of the Command Line Interface CLI CommandsStarting the CLI Stopping the CLI Sample Command Option Description Value Entry CLI Job Control Cdpnum CLI History Commands Overview of Sterling ConnectDirect CommandsCommand Command Abbreviation Description Abbreviations for Common Sterling ConnectDirect Commands Parameter Abbreviation Pname = A?PROD5 Submitting a ProcessParameter Description Values Parameter Description Values Username@hostname or user@localhost Id , pswd Name host name nnn.nnn.nnn.nnn or Name nnnnn Id ,pswd ,newpswd Snodeid field Specify retain=initial Following command submits the Process named payroll Following command submits the Process named copyfil Following command submits the Process named copy.cdp Changing Process ParametersParameter Description Value Name generic list Remote node specification generic list Node specification, userid generic list Deleting a Process from the TCQ Number list Removing a Process from the Execution Queue Flush process command has the following optional parameters Stopping Sterling ConnectDirect Viewing a Process in the TCQ Parameter Description Pname Locate the Process to view EX HC HE HI HO HR HS PE Following command displays the specified Process number Monitoring Process Status in the TCQ All EX HC HE HI HO HR HS PE Output from the command is displayed in the following table Determining the Outcome of a Process Dest=/path/file name Caev Capr CAEV, Capr Record id list Parameter Description Value Parameter Description Value Parameter Description Value Srcf=/path/file name Date day , hhmmss ampm Generating a Detailed Output Report for a Process Running System Diagnostics Generating a Summary Report for a ProcessSelect Statistics Recid LOG Timepname Pnumber Stepname Ccod Fdbk Msgid COMM.TRC Smgr Trace smgr pnode tnode=ath3500ry level=2 file=Smgp.trc Command Definition Overview of the Transmission Control QueueScheduling Sterling ConnectDirect Activity Scheduling Parameter Queue Comments Progression of a Process Through the TCQ Execution Queue Element Comment Wait QueueStatus Comment Timer Queue Hold Queue Held for Call indicates that the Process was Introduction to Translation Tables Creating a Translation Table Compiling a Translation Table Using the ndmxlt Utility Example-Creating a Translation Table Using Translation During File Transfer Operations Example-Modifying a Model Translation Table Translation Table Error Messages Accessing Sterling ConnectDirect MessagesMessage File Content Diagnostic Number Description Following is a sample ndmmsg command Message File Record FormatDisplaying Message Text Following are the parameters for the message file record Sterling ConnectDirect for Unix User Guide Using the Standalone Batch Compression Utility Following are the parameters for the cdsacomp utilityLevel-Compression level Memory-The amount Codepage Source codepage, destinationNnnnn Example-Precompress a Text File Example-Precompress a Text File With Codepage ConversionExample-Precompress a Binary File Example-Decompress a Text File Examples-csdacomp Command Help Validate Configuration Files Configuration ReportsCfgcheck command has the following arguments Argument Description Generating a Configuration Report on the Base Installation Type the following command at a Unix prompt Sterling ConnectDirect Utilities Following example shows an excerpt from a sample report Sterling ConnectDirect Utilities Sterling ConnectDirect for Unix User Guide Program using the C++ API calls Introduction to Writing Custom ProgramsCompiling Custom Programs Compiler version to use for each platform Platform Compile Command You want to create such as apicheck Writing Custom C Programs ++ Function Description Ndmerrenth Ndmnoerror Ndmerror Ndmapirecvresp or Receiving Responses Using ndmapirecvresp or ndmapirecvrespcNdmapirecvrespc Parameter Description Value PNOD-PNODE Following is a sample ndmapirecvresp function SNOD-SNODEReturn Code Description Truncated Ndmapirecvresp or ndmapirecvrespc to retrieve Writing Custom C++ Programs Ndmapisendcmdc function call has the following return codesFollowing is a sample ndmapisendcmd function Selectstatistics or Selectprocess , the CLI Sterling ConnectDirect for Unix User Guide Method Description Parameter Return Values Cdfailure Following is the ConnectDirectSession class header Cdsuccess = 0, Cdfailure = Writing Custom Programs Sterling ConnectDirect for Unix User Guide User Exit Programs User Exit FunctionsProgram Description Chown root exitskeleton Goodrc Errorrc Return Code Waiting for a Message Using recvexitmsg or recvexitmsgc Exitprogram Following are the parameters for sendexitmsg or sendexitmsgc Header Statistics Exit Message Overview of User Exit MessagesFile Open Exit Messages Security Exit Messages Fileopenoutputreplymsg Generatemsg Validatemsg Validatereplymsg Copy Control Block User Exit Stop MessageExit Log Files 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