JAMS Reference Manual

1.6 Variable Definitions

Variables are used to hold single pieces of data which may be used in your batch scheduling and/or processing. A JAMS Variable is a piece of data which can be used:

as a default value for a Job's parameter.
as an undefined parameter in a parsed Job.
in Job Dependencies.
in Trigger Events.
in your application programs and/or DCL command procedures.

Variables can be maintained with the screen, command or Motif based interfaces.

Variable Name

The Variable Name is a unique identifier for a Variable. You can reference a Variable in a JAMS parsed Job by specifying the Variable Name enclosed in double <> signs (i.e. <<variable_name>>). When the Job is submitted, the <<variable_name>> will be replaced with the current value of the Variable.

JAMS also provides commands and routines which allow you to get and/or set the value of a Variable from DCL or a 3GL language.

A Variable Name must be a valid OpenVMS identifier. This means that it must begin with an alphabetic character and contain only the characters A-Z, 0-9, $ (dollar sign), and _ (underscore). Also, the last character may not be an underscore.

Description

This field is used to more fully describe this Variable.

Data Type

You must specify the data type of a Variable. Possible values are:

TEXT Up to 256 bytes of text.

INTEGER A longword integer value.

BOOLEAN A true or false value.

DATE A date.

TIME A time of day.

DATETIME A date and time of day.

FLOAT A floating point number.

UNKNOWN Any data type. JAMS cannot test the value of an unknown Variable other than to see when it changes. You cannot change the value of an unknown Variable with the JAMS full screen interface.

Value

This is the current value of the Variable.

Security

If you are properly authorized, you can view or edit a Variable's Access Control List (ACL). This ACL specifies who may see and/or modify the value of this Variable.

Contents

Index

TEXT	Up to 256 bytes of text.
INTEGER	A longword integer value.
BOOLEAN	A true or false value.
DATE	A date.
TIME	A time of day.
DATETIME	A date and time of day.
FLOAT	A floating point number.
UNKNOWN	Any data type. JAMS cannot test the value of an unknown Variable other than to see when it changes. You cannot change the value of an unknown Variable with the JAMS full screen interface.