Using HLI Control Commands
HLI users can add control commands to their programs to control the operation of the
FOCUS Database Server.
Syntax: How to Issue HLI Control Commands
HLI control commands have the following form
CALL FOCUS ('HLI ',fcb)
where:
- fcb
- Is the File Communication Block.
Prepare the FCB as follows:
- Place the subcommand to be executed in the first 8 bytes of the FCB (replaces filename in FCB words 1 and 2). These subcommands are:
- STOPSINK
- Stops the FOCUS Database Server normally, executing queued requests and
closing all open files.
- HX
- Stops the FOCUS Database Server immediately. Because this command can leave
files vulnerable to damage, it should be used only in an emergency.
- ECHO
- Activates the trace facility that writes information to the HLIPRINT file. This
command must be placed in word 1 of the FCB. The FOCUS Database Server only
writes trace information for HLI programs that place the word ECHO or STAT in word
18 of their FCBs.
- To use the ECHO command, put one of the following values into word 2 of the FCB:
- 0 causes the server to only write trace information for programs that place the
words ECHO or STAT in word 18 of their FCBs.
- 1 causes the server to write trace information for all commands. Equivalent to
starting the Server with the ECHO parameter in word 18 of the FCB.
- 2 turns off the trace facility.
- 3 causes the server to write extended trace information for all commands.
Equivalent to starting the Server with the STAT parameter in word 18 of the FCB.
- Place the value SU in FCB word 6 (SU with two trailing blanks).
- Place the ddname of the communication data set allocated by the source machine in FCB words 9 and 10. The FOCUS Database Server must have this data set allocated to ddname FOCSU.
- Place the password used as the first parameter to the program HLISNK when the FOCUS Database Server was started in FCB words 19 and 20 (see Operating the FOCUS Database Server). If the FOCUS Database Server was started without a password, you cannot use control commands.