TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-44
#CHARACTERRULES Built-In Variable
#CHARACTERRULES Built-In Variable
Use #CHARACTERRULES to obtain or set the name of the file that is currently being
used to define the character-processing rules.
Result
#CHARACTERRULES returns the fully qualified name of the file containing the
character-processing rules currently in effect. This name is CPRULES0, CPRULES1,
or the name of a user-supplied file that contains character rules.
Considerations
•
When starting a TACL process, if #CHARACTERRULES is empty after
TACLLOCL has been invoked, TACL selects CPRULES0. TACL searches for
CPRULES0 in $SYSTEM.SYSTEM, and if CPRULES is not found there, then
TACL searches the same volume and subvolume in which the TACL program file
resides. TACL reports a warning if a CPRULES file does not exist when the user
logs on and TACL tries to access a CPRULES file.
•
Use #PUSH #CHARACTERRULES or (PUSH #CHARACTERRULES) to save a
copy of the current character-processing file name and processing rules. The rules
currently in effect are unchanged. Any error that occurs while pushing
#CHARACTERRULES causes the variable to be popped at once. The current
rules remain unchanged.
•
Use #POP #CHARACTERRULES or (POP #CHARACTERRULES) to revert to the
previous character-processing rules file name and its rules. TACL does not reopen
the file and reread the rules; instead, it uses the copy of the rules that it saved
during the previous #PUSH operation.
•
Use #SET #CHARACTERRULES (or SET VARIABLE #CHARACTERRULES) to
define the name of the file to use as the character-processing rules file.
The syntax of #SET #CHARACTERRULES is:
file-name
is the name of a file containing character-processing rules. TACL searches for
the file in the subvolumes specified in #PMSEARCHLIST, opens the file, reads
in the character-processing rules, and closes the file. These conditions also
apply:
•
TACL maintains an internal copy of the rules.
#CHARACTERRULES
#SET #CHARACTERRULES file-name