C-LANG Statements › ARGS Statement—Pass Arguments (UNIX, Windows, and HP Integrity NonStop Jobs)

ARGS Statement—Pass Arguments (UNIX, Windows, and HP Integrity NonStop Jobs)

The ARGS statement specifies a string of positional arguments to pass to a batch file, script, command, or program.

Supported Job Types

This statement is optional for the following job types:

• UNIX
• Windows
• HP Integrity NonStop

Syntax

This statement has the following format:

ARGS argument ...

argument

Specifies the string argument to pass to the batch file, script, command, or program.

Limits: Case-sensitive

Note: You can pass multiple strings as a single argument by enclosing them in double quotes: “parm1 parm2”

Notes:

• The entire value can be up to 4078 characters.
• Specify multiple arguments by separating them with blank spaces.
• To pass an argument with delimiters (such as spaces and semicolons), enclose the argument in double quotes.
• When you pass multiple arguments, you can use continuation characters such as the hyphen (-).
• If you specify more than one ARGS statement, the second ARGS statement within the job definition overrides the first, with the exception of a blank character string, which is ignored.
• For HP NonStop jobs, if you use an ARGS statement to directly invoke multiple commands, separate each command with a tilde and a semicolon (~;). All of these commands should be surrounded with one set of single quotes. For example:

  ARGS ‘#KEYS~;#MYTERM’
  

Example: Pass Positional Arguments to a Windows Program

This example passes three arguments to a Windows program. The argument "C:\Pay Data\salary.dat" is enclosed with double quotation marks because it contains a space.

ARGS "C:\Pay Data\salary.dat" 341 749

When the program runs, the arguments are set as follows:

Example: Pass Positional Arguments to a UNIX Command

This example passes three arguments to a UNIX command. The argument "user 1" is enclosed with double quotation marks because it contains a space.

ARGS "user 1" 905-555-1212 749

When the command runs, the arguments are set as follows:

Example: Pass Positional Arguments to CA WA Agent for HP Integrity NonStop

This example passes one argument to CA WA Agent for HP Integrity NonStop. The argument "PARM1 PARM2" is enclosed with double quotation marks because it contains a space.

ARGS "PARM1 PARM2"