IBM 4J manual Username@hostname or user@localhost, Id , pswd

Page 14

Parameter

Description

Values

 

 

 

notify

The user e-mail to receive Process completion

username@hostname or user@localhost

 

messages. This parameter uses the rmail utility

 

 

available in the UNIX System V mail facility to

 

 

deliver the completion messages.

 

 

Note: Sterling Connect:Direct does not validate

 

 

the e-mail address or user ID supplied to the

 

 

notify parameter. Invalid e-mail addresses and

 

 

failed E-mail attempts are handled according

 

 

to the local mail facilities configuration.

 

 

 

 

pacct

A string containing information about the

“pnode accounting data” up to 256 characters

 

PNODE. Enclose the string in double quotation

 

 

marks.

 

 

 

 

pnodeid

Security user IDs and passwords at the

id [, pswd]

 

PNODE. The pnodeid subparameters can

id—Specifies a user ID on the PNODE.

 

contain 1–64 alphanumeric characters.

 

 

pswd—Specifies a user password on the

 

 

PNODE. If you specify pnodeid, you must also

 

 

specify id. Identify the ID first and the pswd last.

 

 

 

prty

The priority of the Process in the Transmission

1–15, where fifteen is the highest priority. The

 

Control Queue (TCQ). A Process with a higher

default is 10.

 

priority is selected for execution before a

 

 

Process with a lower priority. The prty value

 

 

does not affect the priority during

 

 

transmission.

 

 

 

 

retain

Determines if Sterling Connect:Direct retains a

yes no initial

 

copy of the Process in the TCQ. Sterling

yes—Specifies that the system retains the Process

 

Connect:Direct assigns a Process number to the

 

Process when it is placed in the retain queue.

in the Hold queue in HR status after execution.

 

When the Process is run, the Process number

no—Specifies that the system deletes the Process

 

assigned to the retain Process is incremented

 

from the TCQ after execution. This is the default.

 

by one. For example, if the Process is assigned

 

 

 

the Process number of 1445 in the retain

initial—Specifies that the system retains the

 

queue, the Process number is 1446 when the

 

Process in the Hold queue in HR status for

 

Process is executed.

 

automatic execution every time the Process

 

 

 

If you specify a start time and set retain=yes,

Manager initializes.

 

 

 

the Process remains in the Timer queue in HR

 

 

status and is submitted at the appropriate

 

 

interval. For example, when

 

 

startt=(Monday,2:00), the Process runs each

 

 

Monday at 2:00 AM. When startt=(,1:00), the

 

 

Process runs daily at 1:00 AM. Sterling

 

 

Connect:Direct does not provide a way to run

 

 

a Process hourly. To do this, you must use the

 

 

UNIX cron utility.

 

 

If no start time is identified, you must issue a

 

 

change process command to release the

 

 

Process for execution. Do not code the startt

 

 

parameter when you specify retain=initial.

 

 

 

 

sacct

Specifies accounting data for the SNODE.

“snode accounting data” up to 256 characters.

 

Setting this value in the submit statement

Enclose the string in double quotation marks.

 

overrides any accounting data specified in

 

 

Process.

 

 

 

 

8Sterling Connect:Direct for UNIX: User Guide

Page 13 Page 15
Image 14
Page 13 Page 15
Contents User Guide Page User Guide Copyright IBM Corporation 1999 Contents Iv Sterling ConnectDirect for Unix User Guide Starting the CLI Overview of the Command Line InterfaceCLI Commands Stopping the CLISample Command Option Description Value EntryCLI Job Control CdpnumCommand CLI History CommandsOverview of Sterling ConnectDirect Commands Command Abbreviation DescriptionAbbreviations for Common Sterling ConnectDirect Commands Parameter AbbreviationParameter Description Values Submitting a ProcessPname = A?PROD5 Parameter Description Values Username@hostname or user@localhost Id , pswdName host name nnn.nnn.nnn.nnn or Name nnnnnId ,pswd ,newpswd Snodeid fieldSpecify retain=initial Following command submits the Process named payroll Following command submits the Process named copyfilParameter Description Value Following command submits the Process named copy.cdpChanging Process Parameters Name generic listRemote node specification generic list Node specification, userid generic listDeleting a Process from the TCQ Number list Removing a Process from the Execution Queue Flush process command has the following optional parameters Stopping Sterling ConnectDirectViewing a Process in the TCQ Parameter DescriptionPname 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 TCQAll 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 nameCaev Capr CAEV, Capr Record id listParameter Description Value Parameter Description Value Parameter Description Value Srcf=/path/file name Date day , hhmmss ampmGenerating a Detailed Output Report for a Process Select Statistics Running System DiagnosticsGenerating a Summary Report for a Process Recid LOG Timepname Pnumber Stepname Ccod Fdbk MsgidCOMM.TRC Smgr Trace smgr pnode tnode=ath3500ry level=2 file=Smgp.trc Scheduling Sterling ConnectDirect Activity Command DefinitionOverview of the Transmission Control Queue Scheduling Parameter Queue CommentsProgression of a Process Through the TCQ Execution Queue Status Comment Wait QueueElement Comment Timer Queue Hold QueueHeld for Call indicates that the Process was Introduction to Translation Tables Creating a Translation TableCompiling a Translation Table Using the ndmxlt Utility Example-Creating a Translation TableUsing Translation During File Transfer Operations Example-Modifying a Model Translation TableMessage File Content Translation Table Error MessagesAccessing Sterling ConnectDirect Messages Diagnostic Number DescriptionDisplaying Message Text Following is a sample ndmmsg commandMessage File Record Format Following are the parameters for the message file recordSterling ConnectDirect for Unix User Guide Level-Compression level Using the Standalone Batch Compression UtilityFollowing are the parameters for the cdsacomp utility Memory-The amountNnnnn Source codepage, destinationCodepage Example-Precompress a Binary File Example-Precompress a Text FileExample-Precompress a Text File With Codepage Conversion Example-Decompress a Text FileExamples-csdacomp Command Help Cfgcheck command has the following arguments Validate Configuration FilesConfiguration Reports Argument DescriptionGenerating a Configuration Report on the Base Installation Type the following command at a Unix promptSterling ConnectDirect Utilities Following example shows an excerpt from a sample report Sterling ConnectDirect Utilities Sterling ConnectDirect for Unix User Guide Compiling Custom Programs Program using the C++ API callsIntroduction to Writing Custom Programs Compiler version to use for each platformPlatform Compile Command You want to create such as apicheckWriting Custom C Programs ++ Function DescriptionNdmerrenth Ndmnoerror NdmerrorNdmapirecvrespc Receiving Responses Using ndmapirecvresp or ndmapirecvrespcNdmapirecvresp or Parameter Description Value PNOD-PNODE Return Code Description Following is a sample ndmapirecvresp functionSNOD-SNODE TruncatedNdmapirecvresp or ndmapirecvrespc to retrieve Following is a sample ndmapisendcmd function Writing Custom C++ ProgramsNdmapisendcmdc function call has the following return codes Selectstatistics or Selectprocess , the CLISterling ConnectDirect for Unix User Guide Method Description Parameter Return Values CdfailureFollowing is the ConnectDirectSession class header Cdsuccess = 0, Cdfailure =Writing Custom Programs Sterling ConnectDirect for Unix User Guide Program Description User Exit ProgramsUser Exit Functions Chown root exitskeletonGoodrc Errorrc Return CodeWaiting for a Message Using recvexitmsg or recvexitmsgc ExitprogramFollowing are the parameters for sendexitmsg or sendexitmsgc HeaderFile Open Exit Messages Overview of User Exit MessagesStatistics Exit Message Security Exit Messages FileopenoutputreplymsgGeneratemsg Validatemsg ValidatereplymsgExit 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