SYNTAX

#include "las.h"

FUNCTION c_hstout (vblock, hosout, hosin, numin, text)

     struct PARBLK      *vblock;
     char               *hosout;
     char                hosin[][CMLEN];
     long               *numin;
     char               *text;

PARAMETERS

vblock (input, PARBLK)

TAE parameter block passed by reference. It is assumed that TAE has been initialized prior to calling c_hstout().

hosout (input, character, length(CMLEN))

Host filename for which the associated history file is to be updated.

hosin (input, character, length (numin)(CMLEN))

Array of input hostnames whose history records are to be copied to the history file associated with hosout. These history records are copied only if the TAE global $HISTRY is set to yes.

numin (input, integer)

Number of host filenames specified in the parameter hosin.

text (input, character, length(*))

Additional history text that is to be written to the history record. If specified, text will be inserted into the history file immediately following the name of the calling PDF, before its parameter list. Text is normally left blank. However, it can be used to indicate a dynamic tutor session or that a process PDF is being invoked from within a procedure PDF.

DESCRIPTION

The c_hstout() routine is used to create/update the associated history file of hosout.

RETURN VALUE

c_hstout() returns

     E_SUCC (0)  --> successful completion
     E_FAIL (-1) --> operation failed

The routine may output error messages if an error occurs while copying old history records to a history file.