IBM 4J manual Parameter Description Values

Page 13

Parameter

Description

Values

 

 

 

class

The node-to-node session on which a Process

1 n

 

can execute. A Process can execute on the class

A numeric value from 1 to the value of maximum

 

specified or any higher session class. The

 

default class is specified as the sess.default

concurrent local node connections

 

parameter of the local.node record in the

(sess.pnode.max). The default value is 1. The

 

initialization parameters file.

value cannot be greater than the maximum

 

 

number of local sessions with primary control.

 

 

 

crc

Determines if crc checking is performed. This

on off

 

parameter overrides settings in the

on—Turns on crc checking.

 

initialization parameter, the network map, and

 

the Process.

off—Turns off crc checking. The default is off.

 

Note: The user must be assigned authority to

 

 

 

change the crc settings in the user authority

 

 

file.

 

 

 

 

hold

Determines if the Process is placed in the Hold

yes no call

 

queue.

yes—Specifies the Process is placed in the Hold

 

 

 

When a Process is submitted with retain=yes

queue in HI status until it is released by a change

 

or retain=call, Sterling Connect:Direct ignores

process command. A Process submitted with

 

the hold parameter.

hold=yes is placed on the Hold queue even if you

 

 

specify a start time.

 

 

no—Specifies that the Process executes as soon as

 

 

resources are available. This is the default.

 

 

call—Specifies that the Process is held until a

 

 

connection is established between the remote

 

 

node and the local node. At that time, the Process

 

 

is released for execution.

 

 

 

maxdelay

How long the submit command waits for the

unlimited hh:mm:ss 0

 

submitted Process to complete execution. This

unlimited—Waits until the Process completes

 

parameter is useful when the command is

 

issued by a shell script. When this parameter is

execution.

 

specified, the script waits until the Process

hh:mm:ss—Waits for an interval no longer than

 

completes before it continues execution. The

 

the specified hours, minutes, and seconds.

 

return code of the Process is stored in the $?

 

 

 

variable if you are using the Bourne or Korn

0—Waits until the Process completes execution. If

 

shell and in $status variable if you are using

 

you specify maxdelay=0, you get the same results

 

the C shell, which the shell script can use to

 

as when you specify maxdelay=unlimited.

 

test the results of Process execution. If you do

 

 

 

not specify maxdelay, no delay occurs.

 

 

If the time interval expires, the submit

 

 

command returns a warning status code and

 

 

message ID to the issuing Process or CLI/API.

 

 

The Process is not affected by the time interval

 

 

expiration and executes normally.

 

 

 

 

newname

A new Process name that overrides the name

A name up to 256 characters long

 

in the submitted Process.

 

 

 

 

Chapter 1. Controlling and Monitoring Processes 7

Image 13
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 CommandsPname = A?PROD5 Submitting a ProcessParameter Description Values 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 Element Comment Wait QueueStatus 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 amountCodepage Source codepage, destinationNnnnn 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 NdmnoerrorNdmapirecvresp or Receiving Responses Using ndmapirecvresp or ndmapirecvrespcNdmapirecvrespc 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 sendexitmsgcStatistics Exit Message Overview of User Exit MessagesFile Open Exit Messages Fileopenoutputreplymsg Security Exit MessagesValidatemsg Validatereplymsg GeneratemsgCopy 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