VARIABLES

Forms Of Variables:

All Variables are either exactly 3 chars long or 5 (or more) characters long. The meaning of every character is as follows:

1. The 1st character, the &, tells the scanner that what follows is a variable.

2. The 2nd character indicates the category of the variable, as follows: :

         D    For Date-type variables (&DY, &DM and &DD).

       T     For Time-type variables (&TH, &TM and &TS).

       N     For Name of Month and Day variables. (&NMLn and &NDLn).

       J     For Job Name, # (Number), Queue and Class variables (&JNLn, &J#Ln, &JQ and &JC)

                   Job-related variables are valid and available if:
                     The preceding object is a JOB stream object, or
                     Entry gets picked up by the Automatic Queue Monitor.

3. The 3rd character further defines the variable within its category. For
        file-qualifier variables, this is a string of one or more digits.

   4. The 4th (or next) character, if required, is normally the letter
        L (Length modifier).

   5. The 5th (or next) character, is a string of one or more digits.

Date-Type Variables (&DY, &DM and &DD):

There are three variables in this category. The length of each variable is exactly three characters long.

1. Current Year (&DY): The length of the value is always 4-characters long.

2. Current Month (&DM): The length of the value is always 2-characters long.
Single Digit months (January though Sept.) always include a leading zero.

3. Current day (&DD): The length of the value for &DM is always 2-characters
long. Single Digit days (1st through 9th) always include a leading zero.

Time-Type Variables (&TH, &TM and &TS):

There are three variables in this category. The length of each variable is exactly three characters long.

1. Current HOUR (&TH): The length of the value is always 2-characters long.
    Range of Values is from 00 through 23, inclusive. Notice that 00 represents
    Midnight.

2. Current MINUTE (&TM): The length of the value is always 2-characters
     long. Range of Values is from 00 thorugh 59, inclusive.

3. Current SECOND (&TS): The length of the value is always 2-characters long.
    Range of Values is from 00 though 59, inclusive.

Name of Month and Day variables (&NMLn and &NDLn):

There are two variables in this category: &NMLn and &NDLn. Notice that both Variables require a length modifier, the L, which must be followed by one or more digits. The Length modifier tells the scanner to use n characters (left to right) from The actual value. Trailing blanks, if any, are stripped off. Invalid length modifier value, such as zero, results in returning the entire name.

Returned value, for both variables, is ALWAYS IN UPPER CASE.

1. Name of current month (&NMLn): Length of returned value is as indicated
    by the length modifier. Max Length is 9 characters long. Any trailing blanks,
    after applying the Length modifier, are stripped off.

2. Name of current day (&NDLn): Length of the returned value is as indicated
    by the length modifier. Max Length is 9 characters long. Any trailing blanks,
    after applying the Length modifier, are stripped off.

Name Of Month Example:

Data set name TEST.&NML9.CLUSTER
evalutes during the month of MARCH to TEST.MARCH.CLUSTER

Notice that only 5 characters were returned eventhough the length modifier specified 9 characters.

Name Of Day Example:

Data set name TEST.&NDL9.CLUSTER
evalutes on a sunday to TEST.SUNDAY.CLUSTER

Notice that only 6 characters were returned eventhough the length modifier specified 9 characters.