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