IBM 4J manual Monitoring Process Status in the TCQ

Page 28

Parameter

Description

Value

 

 

 

submitter

Locate the Processes to view

(node specification, userid) generic (list)

 

by the node specification (the

node specification, userid—Specifies the node

 

Sterling Connect:Direct node

 

name) and user ID of the

specification (the Sterling Connect:Direct

 

Process owner. The length of

node name) and user ID.

 

this parameter is unlimited.

generic—Specifies a nonspecific value for

 

 

 

 

node specification and user ID. This generic

 

 

value, containing pattern-matching

 

 

characters, evaluates to a list of zero or more

 

 

node specifications and user IDs.

 

 

list—Specifies a list of node specification and

 

 

user ID pairs. Enclose the list in parentheses,

 

 

and separate each value with a comma.

 

 

 

The following command displays the specified Process number:

view process pnumber=1;

Monitoring Process Status in the TCQ

The select process command displays information about Processes in the TCQ.

The search criteria provide flexibility in selecting Processes. You can search for a Process by Process name, Process number, queue, secondary node, status, owner of the Process, or any combination of the search criteria parameters.

You also can specify more than one Process in the search criteria. You can request either a detailed report about the selected Process or a short report.

There are no required parameters for this command. If you do not specify an optional parameter, Sterling Connect:Direct selects all Processes executing or waiting for execution. Following are the optional parameters for the select process command:

Parameter

Description

Value

 

 

 

pname

Locate the Process to select

name generic (list)

 

by Process name.

name—Specifies the Process name, up to 8

 

 

 

The Process name is limited

alphanumeric characters.

 

to 8 characters on Sterling

generic—Specifies a nonspecific value for the

 

Connect:Direct for Microsoft

 

Windows and Sterling

Process name. This generic value, containing

 

Connect:Direct for z/OS.

pattern-matching characters, evaluates to a

 

 

list of zero or more pname strings.

 

 

list—Specifies a list of Process names. Enclose

 

 

the list in parentheses, and separate each

 

 

value with a comma.

 

 

 

pnumber

Locate the Process to select

number from 1–99,999 (list)

 

by Process number. Sterling

number—Specifies the Process number.

 

Connect:Direct assigns the

 

Process number when the

list—Specifies a list of Process numbers.

 

Process is submitted.

 

Enclose the list in parentheses, and separate

 

 

 

 

each value with a comma.

 

 

 

22Sterling Connect:Direct for UNIX: User Guide

Image 28
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 CLISample Command Option Description Value EntryCLI Job Control CdpnumCLI History Commands Overview of Sterling ConnectDirect CommandsCommand Command Abbreviation DescriptionAbbreviations for Common Sterling ConnectDirect Commands Parameter AbbreviationPname = A?PROD5 Submitting a ProcessParameter Description Values 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 copyfilFollowing command submits the Process named copy.cdp Changing Process ParametersParameter Description Value 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 Running System Diagnostics Generating a Summary Report for a ProcessSelect Statistics Recid LOG Timepname Pnumber Stepname Ccod Fdbk MsgidCOMM.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 CommentsProgression of a Process Through the TCQ Execution Queue Element Comment Wait QueueStatus 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 TableTranslation Table Error Messages Accessing Sterling ConnectDirect MessagesMessage File Content Diagnostic Number DescriptionFollowing is a sample ndmmsg command Message File Record FormatDisplaying Message Text Following are the parameters for the message file recordSterling ConnectDirect for Unix User Guide Using the Standalone Batch Compression Utility Following are the parameters for the cdsacomp utilityLevel-Compression level Memory-The amountCodepage Source codepage, destinationNnnnn Example-Precompress a Text File Example-Precompress a Text File With Codepage ConversionExample-Precompress a Binary File Example-Decompress a Text FileExamples-csdacomp Command Help Validate Configuration Files Configuration ReportsCfgcheck command has the following arguments 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 Program using the C++ API calls Introduction to Writing Custom ProgramsCompiling Custom Programs Compiler version to use for each platformPlatform Compile Command You want to create such as apicheckWriting Custom C Programs ++ Function DescriptionNdmerrenth Ndmnoerror NdmerrorNdmapirecvresp or Receiving Responses Using ndmapirecvresp or ndmapirecvrespcNdmapirecvrespc Parameter Description Value PNOD-PNODE Following is a sample ndmapirecvresp function SNOD-SNODEReturn Code Description TruncatedNdmapirecvresp 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 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 User Exit Programs User Exit FunctionsProgram Description Chown root exitskeletonGoodrc Errorrc Return CodeWaiting for a Message Using recvexitmsg or recvexitmsgc ExitprogramFollowing are the parameters for sendexitmsg or sendexitmsgc HeaderStatistics Exit Message Overview of User Exit MessagesFile Open Exit Messages Security Exit Messages FileopenoutputreplymsgGeneratemsg Validatemsg ValidatereplymsgCopy 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