IBM Webcam 4J Manual do Utilizador Página 1

Sterling Connect:Direct for UNIXUser GuideVe r s i o n 4 .1

enables you to edit the text of saved Processes, issue UNIX commands, and resolveProcess errors without exiting and reentering the CLI. Use the follow

Abbreviations for Common Sterling Connect:Direct CommandsThe following table lists valid abbreviations for commonly used parameters forSterling Connec

v When typing commands, type the entire command name or type the first threecharacters or abbreviate specific parameters. Refer to “Abbreviations forC

Parameter Description Valuesclass The node-to-node session on which a Processcan execute. A Process can execute on the classspecified or any higher se

Parameter Description Valuesnotify The user e-mail to receive Process completionmessages. This parameter uses the rmail utilityavailable in the UNIX S

Parameter Description Valuessnode Identifies the name of the secondary node.Setting this value overrides the snode value inthe Process statement. The

Parameter Description Valuessnodeid Specifies security user IDs and securitypasswords on the SNODE. The snodeidsubparameters can contain one or moreal

Parameter Description Valuesstartt Identifies the date, day, and time to start theProcess. Sterling Connect:Direct places theProcess in the Timer queu

Parameter Description Valuestracel Specifies the level of trace to perform for aProcess. Tracing by Process can be turned on inthe submit command or a

Example - Submit a Process and Turn On TracingThe following command submits the Process named copy.cdp:submit file=copy.cdp tracel=4 pnode;Because tra

Parameter Description Valuesnode Locate the Process to bechanged by the secondarynode name. This parametercan be used to specify aspecific remote node

Parameter Description Valuehold Moves the Process to the Holdor Wait queue.yes | no | callyes—Places the Process in the Holdqueue in HO status until i

You select the Process to delete by Process name, Process number, secondary nodename, submitter, or any combination of the search criteria parameters.

The following command deletes all nonexecuting Processes submitted by user IDcduser on node dallas:delete process submitter=(dallas, cduser);Removing

Parameter Description Valuesubmitter Locate the Processes toremove by the nodespecification (the SterlingConnect:Direct nodename) and user ID of thePr

You can specify the force, immediate, quiesce, or step parameters with the stopcommand.Note: The force parameter is required when running Sterling Con

Parameter Description Valuepname Locate the Process to viewby Process name.The Process name is limitedto 8 characters on SterlingConnect:Direct for Mi

Parameter Description Valuestatus Specifies the Processes to beviewed by Process status. Ifyou do not specify a statusvalue, information isgenerated f

Parameter Description Valuesubmitter Locate the Processes to viewby the node specification (theSterling Connect:Direct nodename) and user ID of thePro

Parameter Description Valuequeue Specifies the Processes to beselected by the specifiedqueue names. The default isall.all | exec | hold | wait | timer

Sterling Connect:Direct for UNIXUser GuideVe r s i o n 4 .1

Parameter Description Valuestatus Specifies the Processes to beselected by Process status. Ifyou do not specify a statusvalue, information isgenerated

Parameter Description Valuesubmitter Locate the Processes toselect by the nodespecification (the SterlingConnect:Direct node name)and user ID of the P

Determining the Outcome of a ProcessThe select statistics command is used to examine Process statistics from theSterling Connect:Direct statistics fil

Parameter Description Valuepname Locate the statistics toselect by Process name.The Process name islimited to 8 characters onSterling Connect:Directfo

Parameter Description ValueCTRM—Child Process terminated.CUKN—Child Process unknown status.CXIT—Child Process exited.DELP—The delete Process command i

Parameter Description ValuePSTR—Process started.QCEX—A Process moved from another queue tothe EXEC queue.QCWA—A Process moved from another queue tothe

Parameter Description ValueUNKN—Unknown command issued.USEC—Security check for user ID failed.USMG—Sterling Connect:Direct is shuttingdown.XCMM—Comman

Parameter Description Valuesnode Locate the statistics filerecord by the secondarynode name. Thisparameter can be used tospecify a specific remotenode

Parameter Description Valuestopt Specifies that SterlingConnect:Direct searchesfor statistics records up toand including thedesignated date, day, andt

Generating a Summary Report for a ProcessYou can use the select statistics command to generate a summary report for aProcess. The following command ge

NoteBefore using this information and the product it supports, read the information in “Notices” on page 83.This edition applies to version 4.1 of IBM

Parameter Description Valuecmgr To trace the CommandManager.level=0 |1|2|4file=namelevel—Specifies the level of detail displayed inthe trace output. T

Parameter Description Valuepmgr To trace the ProcessManager.level=0 |1|2|4file=namelevel—Specifies the level of detail displayed inthe trace output. T

trace smgr pnode tnode=ath3500ry level=2 file=Smgp.trc;A partial sample trace output is illustrated in the following section. A traceidentifies the Pr

Chapter 2. Process QueuingOverview of the Transmission Control QueueThe TCQ controls Process execution as Sterling Connect:Direct operates. After yous

SchedulingParameter Queue Commentsretain=initial Hold A copy of the Process remains in the Hold queueand executes every time the Process Manager isini

The Execution QueueProcesses are placed in the Execution queue after Sterling Connect:Direct connectsto the remote node. Processes normally come from

After a Process successfully completes, it is automatically deleted from theExecution queue. A flush process command with hold=yes moves a Process fro

The Timer QueueProcesses are placed in the Timer queue by a submit command with the starttparameter specified. Processes in the Wait for Start Time (W

Processes are placed in the Hold queue by a submit command with retain=initial,retain=yes, or hold=yes parameters specified. Processes submitted with

Chapter 3. Sterling Connect:Direct UtilitiesIntroduction to Translation TablesSterling Connect:Direct translates data from one character set code to a

ContentsChapter 1. Controlling and MonitoringProcesses ...1Overview of the Command Line Interface ...1Starting the CLI ...1Stoppi

Compiling a Translation Table Using the ndmxlt UtilityBefore you beginYou can create or modify a translation table tailored to your requirements with

3. Add the following lines to the bottom of the table. It should look like the tablein “Creating a Translation Table” on page 43when you have added th

To specify a customized table for data translation, include the following sysoptssubparameter in the copy statement, where pathname/filename identifie

xxx is a 3-character Sterling Connect:Direct component identifiernnn is a 3-digit decimal numberI is the standard, though not required, suffixMessage

short.text=CMGR RPC call returns NULLlong.text=The ndmapi_sendcmd RPC call made by the API to the CMGR returns aNULL pointer.There is probably an RPC

Using the Standalone Batch Compression UtilityBefore you beginTo invoke the standalone batch compression utility (cdsacomp), type the followingcommand

Parameter Description Values-p Use this option to specify codepages forfile conversion. Default is no codepagetranslation.This parameter is mutually e

Parameter Description Values-a Use this option to replace zero-lengthrecords with a single, blank character.This parameter is valid only when youspeci

cdsacomp -m decompress-d text-i compressed.file-o dest.file-x /home/cd/ndm/xlate/def_recv.xltExamples—csdacomp Command HelpRequesting a summary of cds

Validate Configuration FilesWhen you manually edit any of the five text-based Sterling Connect:Directconfiguration files, the Configuration Checking U

iv Sterling Connect:Direct for UNIX: User Guide

v Sterling Connect:Direct Secure Plus for UNIXv Sterling Connect:Direct for SWIFTNet for UNIXDuring the Sterling Connect:Direct installation, cdcustrp

################################################################################## Connect:Direct for UNIX 4.0.00 configuration report ###############

The following example shows an excerpt from a sample report:===== Begin: Secure+ parameters ==============================================All secure+

Log.MaxVersions="5"[connection.info]# Connection information for Connect:Direct’s API port. (Used when forwarding filesto the back office.)C

58 Sterling Connect:Direct for UNIX: User Guide

Chapter 4. Writing Custom ProgramsIntroduction to Writing Custom ProgramsThe Sterling Connect:Direct Application Programming Interface (API) allows yo

Platform C++ Compile Command64-bit /opt/SUNWspro/bin/CC -xarch=generic64 -DBSD_COMP -I../include -o sdksample sdksample.C../lib/ndmapi64.a-L/usr/ucbli

Platform C Compile CommandHP32-bit /opt/ansic/bin/cc -I../include -o apicheck apicheck.c ../lib/ndmapi.a -lrpcsoc -lnsl -ldld -Wl,+s -lcl-lstd_v2 -lCs

C++ Function C Function Descriptionndmapi_sendcmd() ndmapi_sendcmd_c() Sends commands to Sterling Connect:Direct.You must provide the command text. Th

from the commands. Control returns to the application when the connection isestablished and Sterling Connect:Direct is ready for the first API request

Chapter 1. Controlling and Monitoring ProcessesOverview of the Command Line InterfaceThe Command Line Interface (CLI) enables you to submit Sterling C

Receiving Responses Using ndmapi_recvresp() orndmapi_recvresp_c()Use ndmapi_recvresp() or ndmapi_recvresp_c() to receive responses that areassociated

Parameter Description ValueDDS1—Destination disposition 1DDS2—Destination disposition 2DDS3—Destination disposition 3DESC—Sterling Connect:Directadmin

Parameter Description ValuePNOD—PNODEPNUM—Process numberPPMN—PDS member namePRTY—PriorityQUEU—QueueRECC—Record categoryRECI—Record IDRETA—Retain Proce

Parameter Description ValueSTAT—Process statusSNOD—SNODESNVL—Source number ofvolumesSOPT—SYSOPTS recordSRCR—Records readSRUX—RUs sentSTIM—Schedule tim

Sending a Command to Sterling Connect:Direct Usingndmapi_sendcmd() or ndmapi_sendcmd_c()Use ndmapi_sendcmd() or ndmapi_sendcmd_c() to allow a command

Parameter Description Valuecmd_id A four-byte identifier of the command that was found inthe command text. Following are the four-byteidentifiers:/***

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

Method Description Parameter Return ValuesConnect Provides a connection to theSterling Connect:Direct server.Connect() with a void parameterconnects t

Method Description Parameter Return ValuesGetPreviousError Moves the error data pointer tothe previous error in the list.void TRUE—If successfulFALSE—

// Methods for retrieving ReceiveResponse data...virtual const char *GetResponse(void) = 0;virtual int GetResponseLength(void) = 0;virtual bool MoreDa

Option Description ValueSample CommandEntry-P Identifies the custom string touse at the command lineprompt.If the prompt string includesspaces or spec

74 Sterling Connect:Direct for UNIX: User Guide

Chapter 5. Writing User ExitsUser Exit ProgramsThe user exit API functions allow you to write custom programs to use withSterling Connect:Direct. The

C++ Function C Function Descriptionexit_child_init() exit_child_init_c() Use this function as the first line in a user exitprogram to initialize commu

Waiting for a Message Using recv_exit_msg() orrecv_exit_msg_c()The recv_exit_msg() or recv_exit_msg_c() function waits until it receives a messagefrom

The send_exit_file() or send_exit_file_c() function calls have the following returncodes. Return codes for the function are defined in ndmapi.h.Header

Overview of User Exit MessagesSterling Connect:Direct sends and receives messages, using the send_exit_msg()and the recv_exit_msg() functions for a C+

v UNIX user namev A copy of the Sterling Connect:Direct copy control blockv A copy of the Sterling Connect:Direct parsed sysopts structure (the copy c

v VALIDATE_MSGv VALIDATE_REPLY_MSGCAUTION:If the security exit is used, Sterling Connect:Direct relies on it for user IDauthentication. If the securit

VALIDATE_REPLY_MSGThe user exit program sends a reply message to the Sterling Connect:DirectVALIDATE_MSG. The VALIDATE_REPLY_MSG contains:v Status val

NoticesThis information was developed for products and services offered in the U.S.A.IBM may not offer the products, services, or features discussed i

Option Description ValueSample CommandEntry-e nn Defines the error level abovewhich the CLI automaticallyexits. If the returned error codeis greater t

incorporated in new editions of the publication. IBM may make improvementsand/or changes in the product(s) and/or the program(s) described in thispubl

This information is for planning purposes only. The information herein is subject tochange before the products described become available.This informa

Microsoft, Windows, Windows NT, and the Windows logo are trademarks ofMicrosoft Corporation in the United States, other countries, or both.ITIL is a r

IndexSpecial characters-e nn parameter, direct command 3-h parameter, for direct 3-n name parameter, direct command 3-p nnnnn parameter, direct comman

Iinformational responses, API 62Initializing communications using userexit functions 76Llogfile parameterexit_child_init() function 76MManaging Proces

User Exit Stop Message (continued)STOP_MSG 82Using the Stand-alone Batch CompressionUtility 49Using translation during file transferoperationg 45Utili

90 Sterling Connect:Direct for UNIX: User Guide

Product Number: 5725-C99Printed in USA