COMMAND Statement—Specify Commands (HP Integrity NonStop Jobs)

C-LANG Statements › COMMAND Statement—Specify Commands (HP Integrity NonStop Jobs)

COMMAND Statement—Specify Commands (HP Integrity NonStop Jobs)

The COMMAND statement specifies the command that you want to run on an HP Integrity NonStop system.

Supported Job Type

This statement is required for the HP Integrity NonStop job type.

Syntax

This statement has the following formats:

COMMAND ~;
COMMAND ["]command-file[/run-option[,run-option...]/]["]

command-file

Specifies a file containing the command to run. Follows TACL file naming convention.

Limits: Case-sensitive

run-option

Specifies one of the following options for the command:

CPU cpu-number

Specifies the processor to run the command on.

Limits: Integer from 0 to 15

LIB $library

Specifies a user library file to search for external references from the command. This library is searched before a system library. Specify the system volume, subvolume, and file name.

NAME $process-name

Defines a process name for the command execution. If you do not define a process name, TACL generates one.

Limits: One to five characters (not including $). The first character must be alphabetic and the rest must be alphanumeric.

PRI priority

Defines the execution priority for the command. Commands with higher values execute first.

Limits: Integer from 1 to 199

TERM [\node-name.]$terminal-name

Specifies the name of the home terminal on the HP Integrity NonStop system.

Limits: Terminal-name is one to six alphanumeric characters (not including $).

Notes:

The first format’s value ‘~;’ is used to indicate that the job is directly invoking a command. An ARGS statement should be included in the job containing the commands to run.
The length of the entire COMMAND statement value is limited to 256 characters.
If you specify run-option, enclose the entire COMMAND statement value in double quotes, for example:
```
COMMAND "$C35.PROD.GETDEF/CPU 5, PRI 110, NAME $job1/"
```

Example: Run a Command on an HP Integrity NonStop System

In this example, the COMMAND statement runs program file $C35.PROD.GETAPD. The volume disk name is $C35, the subvolume is PROD, and the file name is GETAPD.

USER prod.glsys                          
AGENT PROAGENT                            
COMMAND $C35.PROD.GETAPD                          
ENVAR ASN1="SNAME;$VOL.SUBVOL.FILE1;PEXT=100;SEXT=500"    
ENVAR PRM1="LNAME=$DATA2.LOGS.LOG1"