Connect:Direct Commands
You have the capability to monitor the status, make specific adjustments, and halt execution by utilizing the relevant commands. The commands provided in the subsequent table empower you to carry out these actions:
| Command | Abbreviation | Description |
|---|---|---|
| submit | sub | Makes Processes available for execution. |
| change process | cha pro | Changes the status and modifies specific characteristics, of a nonexecuting Process in the TCQ. |
| delete process | del pro | Removes a nonexecuting Process from the TCQ. |
| flush process | flush pro | Removes an executing Process from the TCQ. |
| stop | stop | Stops Connect:Direct® for UNIX and returns control to the operating system. |
| select process | sel pro | Monitors both executing Processes and Processes waiting for execution. You can specify the search criteria and the form in which the information is presented. |
| select statistics | sel stat | Retrieves information from the statistics file. You can specify the search criteria and the form in which the information is presented. |
| view process | view pro | View a Process in the TCQ where the local node is the Pnode. View process can only display Processes running on the local node since only the Pnode has the information required to display a Process. |
Abbreviations for Common IBM Connect:Direct Commands
The following table lists valid abbreviations for commonly used parameters for IBM® Connect:Direct commands:
| Parameter | Abbreviation |
|---|---|
| detail | det |
| quit | q |
| recids | rec |
| release | rel |
| pname | pnam, pna |
| pnumber | pnum |
| sunday | sun |
| monday | mon |
| tuesday | tue |
| wednesday | wed |
| thursday | thu |
| friday | fri |
| saturday | sat |
| today | tod |
| tomorrow | tom |
Restricting the Scripts and UNIX Commands Users Can Execute
System administrators and other network operations staff can restrict the scripts and UNIX commands that you can execute with the run task and run job Process statements. System administrators and other network operations staff can enforce the following limits on the capabilities you have with IBM Connect:Direct:
- The capability to send or receive files; you may be limited either to sending files only or to receiving files only.
- The locations to or from which you can send or receive files; you may be limited to specific local or remote nodes.
Check with the system administrator for a list of specific restrictions for your user ID.
IBM Connect:Direct Command Syntax
Use the same command syntax for commands typed at the CLI prompt or used as the command text parameter for an ndmapi_sendcmd() function. Refer to Writing User Exits, for details on function calls. The following conventions are used when typing commands:
- When selecting a password or user ID, do not use IBM Connect:Direct keywords.
- Be aware that user names and file names are case sensitive.
- Type an individual command keyword in uppercase, lowercase, or mixed-case characters.
- Terminate all commands with a semicolon (;).
- When typing commands, type the entire command name or type the first three characters or abbreviate specific parameters. Refer to Abbreviations for Common IBM Connect:Direct Commandsfor a list of abbreviations.
- Do not abbreviate Process statements and parameters.
- File names, group names, user IDs, and passwords are variable length strings and can be any length.
- A IBM Connect:Direct node name is 1–16 characters long. The name of a record in the netmap describing a remote node is typically the remote IBM Connect:Direct node name, but can be any string 1–256 characters long. You can also specify a remote node name as an IP address or hostname and a port number or port name.
“Generic” Parameter Value
When the word generic is specified as a parameter value in a syntax definition, provide a string that can include the asterisk (*) and question mark (?) characters. These characters provide a pattern matching or wildcard facility for parameter values. The asterisk matches zero or more characters, and the question mark matches any single character. The following sample illustrates the use of the asterisk and question mark characters:
PNAME = A?PROD5*The generic Process name specified in the previous sample shows a specification that matches all Processes beginning with the letter A, followed by any single character in position two with the string PROD5 in positions three through seven. The asterisk takes the place of zero or more characters beginning in position eight.
“List” Parameter Value
When (list) is a parameter value, you can specify multiple parameter values by enclosing the group in parentheses and separating each value with a comma. A list can also include generic values. The following command illustrates a list:
(pnumber1, pnumber2, pnumber3)