next up previous contents
Next: Usage Up: No Title Previous: Introduction

Routine Descriptions

The HIST'137 routines available are:

HIST_ADD - Add standard record to existing HISTORY structure

     SUBROUTINE HIST_ADD (LOC, NAME, STATUS)

Name = name of calling application A new HISTORY structure will be created if necessary.

HIST_COPY - Copies HISTORY structure from ILOC to OLOC

     SUBROUTINE HIST_COPY (ILOC, OLOC, STATUS)

ILOC obeys point a) above. OLOC does NOT; the HISTORY is copied into the structure located by OLOC.

HIST_FIND - Find current HISTORY record

     SUBROUTINE HIST_FIND (LOC, RECORD, STATUS)

RECORD is a locator to the current HISTORY record. VERY few (if any) applications will need to use this.

HIST_INIT - Initialize HISTORY common block

     SUBROUTINE HIST_INIT

Applications MUST call this or AST_INIT

HIST_NEW - Create a new HISTORY structure (will delete any existing one)

     SUBROUTINE HIST_NEW (LOC, STATUS)

HIST_NREC - Enquire current number of HISTORY records

     SUBROUTINE HIST_NREC (LOC, COUNT, STATUS)

VERY few applications will need to use this.

HIST_OK - Is there a HISTORY structure present?

     SUBROUTINE HIST_OK (LOC, OK, STATUS)

Called by many of the other HIST'137 routines. Few applications will need to use this.

HIST_PTXT - Puts text component into current HISTORY record

     SUBROUTINE HIST_PTXT (LOC, NLINE, TEXT, STATUS)

LOC obeys point a) above. NLINE is the number of text lines in the character array TEXT



Web Master
Wed Oct 8 15:26:34 BST 1997