C-LANG Statements › PARAMETER Statement—Specify an Input Parameter (HP Integrity NonStop Jobs)

PARAMETER Statement—Specify an Input Parameter (HP Integrity NonStop Jobs)

The PARAMETER statement enables you to specify a parameter to pass to an HP Integrity NonStop job. The parameter persists only for the current job and it is set in the environment of the command that the agent runs.

Supported Job Types

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

Syntax

This statement has the following format:

PARAMETER NAME(name) VALUE(value)

name

Specifies the parameter name.

Limits: Maximum of 31 characters. Case-sensitive. You can use the following characters: alphanumeric, hyphen, and circumflex (up caret).

Note: Although the name field is case-sensitive, the value of the name when comparing parameters names is not case-sensitive. If duplicate names are detected, the last one encountered is passed to the job. For example, PARAMETER NAME(abc) VALUE(not used) is coded followed by PARAMETER NAME(ABC) VALUE(used), the executing program receives ABC=used.

value

Specifies the parameter value.

Limits: Maximum of 255 characters. Case-sensitive. You can use the following delimiters: comma, semicolon, and space. Enclose the full text string in single quotes when delimiters are in use.

Note: The combined length of all the PARAMETER statements in a job cannot exceed 511 characters minus the number of entities coded. For example, if 64 PARAMETER statements are coded, the maximum length for all PARAMETER data is 511 – 64.

Example: PARAMETER Statement

In this example, the PARAMETER statements set parameter ABC to ‘100’ and parameter XYZ to ‘200’.

AGENT PROAGENT
USER prod.glsys
COMMAND $C35.TCSOBJ.OABC
ENVAR STDOUT=$C35.TCSOBJ.cafout1
ENVAR STDERR=$c35.srkobj.caferr1
ASSIGN "$VOL.SUBVOL.FILE1;$VOL1.SUBVOL1.FILE2"
PARAMETER NAME(ABC) VALUE(100)
PARAMETER NAME(XYZ) VALUE(200)
DEFINE "MYFIL1;CLASS=MAP;FILE=$DATA2.TCSDEMO.FINFOJOB"