Submit Macros

The following is a complete list of the known "Macro Expansion" capabilities of the Submit facility. In the descriptions below the following notation will be used.

¢ Submit escape character
% is the macro definition character
N is the number of the Executive parameter
b represents a textual delimiter - any single character may be used
  as a delimiter

Macro       Macro Function

¢1b         where b is any user selected character. This sequence
            allows real keyboard input until the character b is typed.
            The 1b escape sequence and the b entered at the keyboard
            are discarded.

¢2          terminates the currently running submit file and returns
            the source for character input to the keyboard.

¢¢          enter '¢' into the submit file

%'          macro comment until EOL or ' encountered, including EOL
            or '

%"          macro comment until EOL or " encountered, but EOL is
            processed.

%%          enter '%' into the submit file

%N          enter executive subparam N into the submit file
            (0 <= N <= 9)

%>N         enter all subparams greater than N into the submit file

%?NbTEXTb   enter TEXT into the submit file if subparam N is nonempty
            (b is any character used as a delimeter)

%#NbTEXTb   enter TEXT into the submit file if subparam N is empty

%?>NbTEXTb  enter TEXT into the submit file if any subparam >N is
            nonempty

%#>NbTEXTb  enter TEXT into the submit file if all subparams >N are
            empty

%[          Expands to default volume name (Without [])

%<          Expands to default directory name (Without <>)

%^          Expands to default password (Without ^)

%U          Expands to User Name

Example --
    This is your default volume %[
    This is your default directory %<
    This is your default password %^
    This is your User Name %U

Produces the following:
    This is your default volume D0
    This is your default directory Chas
    This is your default password abc
    This is your User Name CEB
 

Macro       Macro Function

%DbTEXTb    expand TEXT as date/time using FormatDateTime facility

            Text Expansion

            !h!  hour in 12-hour notation (1-12)
            !t!  hour in 24-hour notation (0-23)
            !m!  minute (0-59)
            !s!  second (0-59)
            !a!  AM/PM
            !y!  year (1952-2042)
            !o!  month number (1-12)
            !n!  month name
            !d!  day of month (1-31)
            !w!  weekday name

When using the datetext macros each occurrence of the key symbol between the enclosing !'s determines the actual format. The * symbol can be used to control the format also. When the first character following the ! is a * the key symbol needs to appear only once to obtain a complete expansion for the macro.

Examples --

    !yyyy!     1984
    !yy!       84
    !*y!       1984
    !nnnnnnnn! November
    !nnn!      Nov
    !n!        N

    %D|!*w! !*n! !*d!, !yyyy!, !*t!:!0m!|

    Thursday November 20, 1984, 9:22