IBM 4J manual Deleting a Process from the TCQ

Page 21

Parameter

Description

Value

 

 

 

hold

Moves the Process to the Hold

yes no call

 

or Wait queue.

yes—Places the Process in the Hold

 

 

 

 

queue in HO status until it is released

 

 

by another change process command.

 

 

no—Places the Process in the Wait

 

 

queue in WC (Waiting for Connection)

 

 

status; the Process executes as soon as

 

 

resources are available. This is the

 

 

default.

 

 

call—Places the Process in the Hold

 

 

queue in HC (Hold for Call) status

 

 

until the remote node (SNODE)

 

 

connects to the local node (PNODE) or

 

 

another Process is submitted. At that

 

 

time, Sterling Connect:Direct releases

 

 

the Process for execution

 

 

 

newsnode

Specifies a new remote node

new remote node specification

 

name to assign to the Process.

 

 

 

 

prty

Changes the priority of the

1–15, where 15 is the highest priority. If

 

Process on the TCQ. Sterling

you do not specify prty, the default is

 

Connect:Direct uses the prty

10.

 

parameter for Process

 

 

selection. A Process with a

 

 

higher priority is selected for

 

 

execution before a Process

 

 

with a lower priority. The prty

 

 

value does not affect the

 

 

priority during transmission.

 

 

 

 

release

Releases the Process from a

none

 

held state. This parameter is

 

 

equivalent to hold=no.

 

 

 

 

tracel

Changes the level of trace to

level = 0 1 2 4

 

perform for a Process.

level—Specifies the level of detail

 

 

 

If you identify the SNODE or

displayed in the trace output. The

 

PNODE immediately after the

default is 4.

 

trace level definition, the trace

0—Terminates the trace. 1—Is the basic

 

level is turned on for all

 

Processes submitted to and

level that provides function entry and

 

from the node identified.

function exit. 2 —Includes level 1 plus

 

 

function arguments. 4—Enables a full

 

 

trace. Basic diagnostic information,

 

 

such as values of internal data

 

 

structures at key points in the

 

 

execution flow, are displayed.

 

 

 

The following command changes the remote node name for the Process named cdproc to a new remote node, paris:

change process pname=cdproc newsnode=paris;

Deleting a Process from the TCQ

The delete process command removes a nonexecuting Process from the TCQ.

Chapter 1. Controlling and Monitoring Processes 15

Image 21
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 CommandsSubmitting a Process Pname = A?PROD5Parameter 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 Wait Queue Element CommentStatus 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 amountSource codepage, destination CodepageNnnnn 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 NdmnoerrorReceiving Responses Using ndmapirecvresp or ndmapirecvrespc Ndmapirecvresp orNdmapirecvrespc 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 sendexitmsgcOverview of User Exit Messages Statistics Exit MessageFile Open Exit Messages Fileopenoutputreplymsg Security Exit MessagesValidatemsg Validatereplymsg GeneratemsgUser Exit Stop Message Copy Control BlockExit 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