KPG1_ASFFR

Finds an Frame with a given Domain within a FrameSet

Description:

This routine finds the last Frame with a given Domain within a FrameSet, and returns its index. The Current Frame in the FrameSet is not changed.

The first and last component Frames within CmpFrames are included in the search (component Frames in the middle of a CmpFrame cannot be found as yet). If a matching Frame is found within a CmpFrame, then a copy of the matching Frame is appended to the FrameSet. The returned Frame index refers to this extracted component Frame, rather than the CmpFrame from which it was extracted.

Invocation

CALL KPG1_ASFFR( TARGET, DOMAIN, IFRM, STATUS )

Arguments

TARGET = INTEGER (Given)
An AST pointer for a FrameSet containing the Frames to be searched.
DOMAIN = CHARACTER ∗ ( ∗ ) (Given)
The Domain name to be searched for.
IFRM = INTEGER (Returned)
The index of the matching Frame within the returned FrameSet. Returned equal to AST__NOFRAME if no match was found, or if an error occurs.
STATUS = INTEGER (Given and Returned)
The global status.