x

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 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.