home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.barnyard.co.uk
/
2015.02.ftp.barnyard.co.uk.tar
/
ftp.barnyard.co.uk
/
cpm
/
walnut-creek-CDROM
/
ZSYS
/
SIMTEL20
/
ZCPR3
/
ALIAS.HLP
< prev
next >
Wrap
Text File
|
2000-06-30
|
4KB
|
167 lines
;
The ZCPR3 ALIAS Facility
A - The ALIAS Command
E - ALIAS Examples
S - Summary of ALIAS Variables
:A
Command: ALIAS 1.1
Syntax:
ALIAS <-- Define New Command
or
ALIAS dir:ufn <-- Redefine Old Command
Function:
Thσá ALIA╙ facilit∙ i≤ thσ scrip⌠ expansioε utilit∙á oµ ì
ZCPR3«á Aε Alia≤ i≤ ß CO═ filσ createΣ b∙ thσ ALIA╙ prograφ ì
whicΦáá contain≤áá onσá o≥á morσá command≤áá (separateΣáá b∙ ì
semicolons⌐ t∩ bσ placeΣ iε thσ CommanΣ Linσá Buffer«á Wheε ì
thσá Alia≤ i≤ invoked¼á parameter≤ froφ thσ commanΣ linσ arσ ì
implanteΣá int∩ thσ scrip⌠ containeΣ withiε thσá Alias¼á anΣ ì
thσá resultinτ ne≈ commanΣ linσ i≤ placeΣ int∩á thσá CommanΣ ì
Linσ Buffe≥ anΣ executed.
Options:
None
Comments:
ZCPR│ MUS╘ bσ implementeΣ witΦ aε Externa∞ CommanΣ Linσ ì
Buffer in order for ALIAS to work.
Thσá scrip⌠á oµá thσá interna∞á commanΣá linσá support≤ ì
paramete≥á passinτ iε ß manne≥ simila≥ t∩ ZE╪ anΣ SUB«á Thσ ì
variable≤á $n¼á wherσ ░ <╜ ε <╜ 9¼á ma∙ bσ placeΣá int∩á thσ ì
script¼ anΣ thσ correspondinτ parameter≤ wil∞ bσ substituteΣ ì
fo≥ thσ indicateΣ variables« Thσ variablσ $░ i≤ thσ namσ oµ ì
thσ Alia≤ itself« Thσ variablσ $¬ i≤ thσ entirσ tai∞ oµ thσ ì
command line.
Tw∩á additiona∞ variables¼á $─ anΣ $U¼á arσá available« ì
$─á expand≤ int∩ thσ lette≥ oµ thσ disδ whicΦ wa≤ loggeΣá iε ì
a⌠á thσ timσ thσ Alia≤ wa≤ expandeΣ (thσ homσ disk)¼á anΣ $╒ ì
expand≤ int∩ ß numbe≥ (iε ASCI╔ chars⌐ representinτ thσ use≥ ì
areß whicΦ wa≤ loggeΣ iε a⌠ thσ timσ thσ Alia≤ wa≤á expandeΣ ì
(the home user).
Thσá ZCPR│ Systeφ filσ name≤ arσ availablσ t∩ thσ Alia≤ ì
a≤ thσ variable≤ $Fε anΣ $Nn¼ wherσ ▒ <╜ ε <╜ 4« $F▒ refer≤ ì
t∩ FILENAME.TY╨ oµ Systeφ Filσ 1¼á $N▒ refer≤ t∩ FILENAM┼ oµ ì
Systeφ Filσ 2¼á etc«á Notσ tha⌠ thσ SETFIL┼ commanΣ i≤ useΣ ì
to define the contents of the System file names.
'$$' expands into a single '$'.
Summary of Alias Variables
$0 - Name of Alias
$n - Parameter from Command Line (1 <= n <= 9)
$* - Tail of Command Line (everything after the verb)
$D - Home Disk
$U - Home User
$Fn - FILENAME.TYP of System File n (1 <= n <= 4)
$Nn - FILENAME of System File n
$$ - The character '$'
Selected Error Messages:
"Ovfló mean≤ tha⌠ thσ expandeΣ commanΣá line¼á combineΣ ì
witΦá thσá remainde≥á oµ thσ content≤ oµá thσá commanΣá linσ ì
buffer, is too long to fit in the command line buffer.
Examples of Use:
ALIAS
-- define Alias
ALIAS alias
-- display script of "alias.COM" and edit
:S
Summary of Alias Variables
$0 - Name of Alias
$n - Parameter from Command Line (1 <= n <= 9)
$* - Tail of Command Line (everything after the verb)
$D - Home Disk
$U - Home User
$Fn - FILENAME.TYP of System File n (1 <= n <= 4)
$Nn - FILENAME of System File n
$$ - The character '$'
:E
Examples of Aliases
Case 1:
Thσá use≥ i≤ constantl∙ issuinτ thσ followinτá command≤ ì
in the order indicated:
ASM myfile.BBZ
LOAD myfile
He can generalize it with the following Alias script:
ASM $1.BBZ;LOAD $1
If this Alias is named MYASM.COM, then typing
"MYASM test" will be equivalent to "ASM test.BBZ;LOAD test"
Case 2:
Thσá use≥ ha≤ tw∩ printer≤ oε hi≤ system«á Hσ i≤ usinτ ì
redirectablσ I/╧ a≤ implementeΣ unde≥ ZCPR3¼á anΣ hσ ha≤ tw∩ ì
version≤ oµ WorΣ Sta≥ (trademark¼á Micropro⌐ - onσ fo≥á eacΦ ì
printer«á Hσá caε creatσ aε Alia≤ containinτ thσá followinτ ì
script:
Script Meaning
I╞ NEC=$▓ Checδ t∩ seσ iµ 2nΣ parφ i≤ NEC
DEV L NEC If so, assign LST to NEC
WSN $1 and run NEC version of WS
ELSE If not ...
DEV L TTY assign LST to TTY
WST $1 and run TTY version of WS
FI
If the Alias was named WSTAR, then:
"WSTAR myfile.txt"
would be equivalent to
DEV L TTY;WST myfile.txt
and
"WSTAR myfile.txt NEC"
would be equivalent to
DEV L NEC;WSN myfile.txt